CODE

Golang 新手入门-从零搭建开发环境并编写第一个Hello World程序

2025/09/15 Golang 共 2769 字，约 8 分钟

Golang 入门：环境搭建与第一个程序

Go语言（或称Golang）是Google开发的一种静态强类型、编译型、并发型，并具有垃圾回收功能的编程语言。它以其简洁的语法、高效的并发处理能力和出色的性能，在云计算、微服务、区块链和命令行工具等领域广受欢迎。本文将手把手带你完成Go语言的开发环境搭建，并编写你的第一个Go程序。

一、Go语言环境安装

Windows系统安装

  1. 下载安装包： 访问Go语言官方下载页面（https://golang.org/dl/ ），选择Microsoft Windows版本的安装包（如 go1.21.1.windows-amd64.msi）。

  2. 运行安装程序： 双击下载的MSI文件，按照安装向导提示进行操作。安装程序默认会将Go安装到 C:\Go\ 目录，并会自动设置必要的环境变量。

  3. 验证安装： 安装完成后，打开命令提示符（CMD）或PowerShell，输入以下命令：

    go version

    如果安装成功，将会显示安装的Go版本号，例如：go version go1.21.1 windows/amd64。

macOS系统安装

macOS用户同样可以从官网下载PKG安装包，也可以使用Homebrew这一流行的包管理器进行安装。

使用Homebrew安装：

brew update
brew install go

安装完成后，同样在终端中执行 go version 来验证安装。

Linux系统安装

以Ubuntu/Debian为例，可以使用apt包管理器安装预编译的Go包。

sudo apt update
sudo apt install golang-go

或者，为了获取最新版本，你也可以从官网下载Linux版本的压缩包，解压到 /usr/local 目录，并手动设置环境变量。

二、配置工作区与环境变量

在旧版本的Go中，GOPATH是一个非常重要的环境变量，它指定了你的工作区目录。虽然新版本使用Go Modules后对GOPATH的依赖降低，但理解它仍有必要。

  1. 查看环境变量： 安装后，系统通常会自动设置GOROOT（Go的安装路径）和GOPATH（你的工作区路径）。可以通过以下命令查看：
    go env GOROOT
go env GOPATH

    默认的GOPATH在Windows上是 %USERPROFILE%\go，在macOS/Linux上是 $HOME/go。

  2. （可选）自定义GOPATH： 如果你希望使用其他目录作为工作区，可以手动设置环境变量。
    • Windows：在“系统属性”->“高级”->“环境变量”中，新建一个用户变量，变量名为GOPATH，变量值为你的工作区路径（如D:\mygo）。
    • macOS/Linux：将以下命令添加到 ~/.bashrc 或 ~/.zshrc 文件中，然后执行 source ~/.bashrc。
      export GOPATH=$HOME/mygo
export PATH=$PATH:$GOPATH/bin

你的工作区目录通常包含三个子文件夹：

  • src: 存放你的Go源代码（.go文件）
  • pkg: 存放编译后的包文件
  • bin: 存放编译后可执行程序

三、选择并配置代码编辑器

一个强大的编辑器能极大提升开发效率。推荐使用Visual Studio Code（VS Code） + Go扩展。

  1. 安装VS Code：从 https://code.visualstudio.com/ 下载并安装。

  2. 安装Go扩展： 打开VS Code，点击左侧扩展图标（或按 Ctrl+Shift+X），搜索“go”，找到由Go Team at Google发布的扩展并点击安装。

  3. 安装必要的工具： VS Code可能会提示你安装一些Go语言工具（gopls, dlv等）。按照提示安装即可，这些工具提供了代码补全、格式化、调试等强大功能。

四、编写第一个Go程序：Hello World

现在，让我们开始编写经典的“Hello, World!”程序。

  1. 创建项目目录： 在你的GOPATH/src目录下（或者任何你喜欢的目录，现在更推荐使用Go Modules outside GOPATH），创建一个新文件夹hello。
    mkdir hello
cd hello
  2. 初始化Go Modules（推荐）： 使用Go Modules可以方便地管理项目依赖。在项目根目录执行：
    go mod init hello

    这会创建一个名为 go.mod 的文件，用于定义模块名和管理依赖。

  3. 创建Go源码文件： 在hello目录下，创建一个名为 main.go 的文件。

  4. 编写代码： 用VS Code打开main.go文件，输入以下代码：
    package main  // 声明 main 包

import "fmt"  // 导入 fmt 包，用于格式化输出

func main() { // 声明 main 函数，是程序执行的入口
    fmt.Println("Hello, World!") // 调用 fmt 包的 Println 函数，输出字符串
}
    • package main： 每个Go程序都必须有一个main包。
    • func main()： main函数是程序开始执行的函数。
    • import "fmt"： 导入标准库中的fmt包，它实现了格式化输入输出的功能。
    • fmt.Println： 是fmt包中的一个函数，用于将内容输出到标准输出（控制台），并自动换行。

五、运行与编译程序

你有两种方式来执行这段代码：

  1. 直接运行（使用go run）： 这是一种非常方便的方式，它会先编译代码，然后立即执行生成的临时可执行文件。在终端中，进入main.go所在的目录，执行：
    go run main.go

    终端将会输出：Hello, World!

  2. 编译后运行（使用go build）： 如果你想得到一个可重复使用的二进制可执行文件，可以使用go build。
    go build -o hello.exe main.go # Windows系统
# 或者
go build -o hello main.go     # macOS/Linux系统

    这条命令会在当前目录编译生成一个名为hello（或hello.exe）的可执行文件。之后，你可以直接运行这个文件：

    ./hello        # macOS/Linux
.\hello.exe    # Windows

六、总结与下一步

恭喜你！你已经成功搭建了Go语言开发环境，并运行了你的第一个程序。你学会了：

  • 如何在主流操作系统上安装Go。
  • 了解GOPATH和工作区的结构。
  • 如何使用VS Code配置高效的Go开发环境。
  • 使用go run和go build命令来运行和编译程序。
  • 理解了Go程序的基本结构：包声明、导入语句和main函数。

下一步，你可以继续学习Go的基础语法，例如变量声明、数据类型、控制流（if/for）、函数定义以及Go最特色的并发编程模型——Goroutine和Channel。官方文档（https://golang.org/doc/ ）和“A Tour of Go”交互式教程（https://tour.golang.org/welcome/1 ）是极好的学习资源。

文档信息

Search

    Table of Contents