顾乔芝士网

本文主要针对Mac电脑上的Go语言环境安装。

IDE使用的Visual Studio Code。

目标:

1. 在 macOS 上安装 Go 语言环境。
2. 配置 VS Code 以支持 Go 开发（代码提示、格式化、调试等）。
3. 创建一个简单的 "Hello, World" Go 程序并运行。

步骤:

第一步：安装 Visual Studio Code

如果你还没有安装 VS Code，请先安装它：

1. 访问 VS Code 官网下载页面：https://code.visualstudio.com/Download
2. 选择 macOS 的 Universal 版本（适用于 Intel 和 Apple Silicon 芯片）。
3. 下载 .zip 文件后，解压缩并将 Visual Studio Code.app 拖到你的 "应用程序" (Applications) 文件夹中。
4. （可选但推荐）打开 VS Code，按下 Cmd + Shift + P 打开命令面板，输入 Shell Command: Install 'code' command in PATH 并回车。这样你就可以在终端里使用 code . 命令在当前目录打开 VS Code。

第二步：安装 Go 语言

推荐使用官方的 macOS 安装包，它会自动处理大部分配置。

1. 访问 Go 官网下载页面: https://go.dev/dl/

2. 下载 macOS 安装包: 找到 "Featured downloads" 或 "Stable versions" 部分，点击 "Apple macOS" 对应的 .pkg 文件下载（通常是 goX.Y.Z.darwin-amd64.pkg 或 goX.Y.Z.darwin-arm64.pkg，根据你的 Mac 芯片选择，或者下载 Universal 包）。

3. 运行安装包: 双击下载的 .pkg 文件，按照安装向导的提示完成安装。
4. 它通常会将 Go 安装在 /usr/local/go 目录下。
5. 安装程序会自动将 /usr/local/go/bin 添加到你的系统 PATH 环境变量中（通常是通过在 /etc/paths.d/ 目录下创建一个文件）。
6. 验证安装:
7. 完全关闭 并 重新打开 你的终端应用程序（Terminal 或 iTerm2）。这很重要，确保环境变量生效。
8. 在新的终端窗口中，输入以下命令并回车：

go version

9. 如果安装成功，你应该能看到类似 go version go1.2x.y darwin/amd64 或 go version go1.2x.y darwin/arm64 的输出。
10. 再输入以下命令查看 Go 的环境变量设置：

go env

9. 留意 GOROOT (应指向 /usr/local/go) 和 GOPATH (默认通常是 $HOME/go)。GOPATH 是你的工作区目录，存放下载的第三方包和你的项目代码（虽然 Go Modules 改变了其部分用途，但它仍然重要）。

第三步：配置 Go 环境变量 (检查与可选设置)

虽然安装包通常会配置好 PATH，但了解一下总没错。GOPROXY 对于国内开发者非常重要。

1. 检查 PATH: 在终端输入 echo $PATH。确认输出中包含 /usr/local/go/bin。如果没有，你需要手动添加。
2. 确定你使用的 Shell：输入 echo $SHELL。通常是 /bin/zsh (Zsh) 或 /bin/bash (Bash)。
3. 对于 Zsh: 编辑 ~/.zshrc 文件 (如 nano ~/.zshrc 或用 VS Code 打开)。在文件末尾添加 export PATH=$PATH:/usr/local/go/bin。保存后执行 source ~/.zshrc 使其生效。
4. 对于 Bash: 编辑 ~/.bash_profile 或 ~/.bashrc 文件。添加同样的内容并执行 source ~/.bash_profile 或 source ~/.bashrc。
5. 设置 GOPROXY (强烈推荐国内用户设置): Go 默认从国外服务器下载依赖包，速度可能很慢或失败。设置国内代理可以解决这个问题。
6. 在终端执行以下命令设置代理，默认的是https://proxy.golang.org (这里使用七牛云的代理，你也可以选择其他的，如阿里云 https://mirrors.aliyun.com/goproxy/):

go env -w GOPROXY=https://goproxy.cn,direct

7. GOPROXY 环境变量允许多个 URL，用逗号分隔。direct 表示如果前面的代理都失败了，就直接连接源站。-w 参数会将设置永久写入 Go 的环境配置文件中。
8. 检查 GOPATH: 默认是 $HOME/go。你可以通过 go env GOPATH 查看。如果想修改，可以设置环境变量 export GOPATH=/path/to/your/workspace 并添加到你的 shell 配置文件 (.zshrc 或 .bash_profile) 中。但对于现代 Go Modules 项目，GOPATH 的重要性有所下降，保持默认通常没问题。

第四步：在 VS Code 中安装 Go 扩展和工具

1. 打开 VS Code。
2. 打开扩展视图: 点击左侧边栏的方块图标，或者按 Cmd + Shift + X。
3. 搜索 Go 扩展: 在搜索框中输入 Go。
4. 安装官方扩展: 找到名为 "Go" 的扩展，发布者是 "Go Team at Google"，点击 "Install"。

5. 安装 Go 开发工具: 安装完 Go 扩展后，通常 VS Code 会在右下角弹出一个提示，告诉你一些 Go 工具（如 gopls - Go 语言服务器，dlv - 调试器等）没有安装，并询问是否安装。
6. 点击 "Install All"。VS Code 会在后台运行 go install 命令来安装这些必要的工具。你可以在 VS Code 的 "OUTPUT" 面板（选择 "Log (Window)" 或 "Go"）查看安装进度。
7. 如果没看到提示，或者想手动安装/更新:
8. 按下 Cmd + Shift + P 打开命令面板。
9. 输入 Go: Install/Update Tools 并回车。
10. 勾选所有列出的工具（特别是 gopls）。
11. 点击 "OK"。

第五步：创建并运行你的第一个 Go 程序

现在我们来创建一个使用 Go Modules 的简单项目。

1. 创建项目目录: 在终端中，选择一个你喜欢的位置创建项目目录（建议放在 GOPATH 之外，例如你的用户主目录下的 projects 文件夹）。

mkdir -p ~/projects/hello-go # -p 确保父目录存在
cd ~/projects/hello-go 

2. 初始化 Go Modules: 在项目根目录下执行此命令。这会创建一个 go.mod 文件，用于管理项目的依赖。

go mod init hello-go # 'hello-go' 是你的模块名，通常是项目名或仓库路径

3. 创建 Go 源文件:

touch main.go

5. 用 VS Code 打开项目:

code . # 如果你安装了 'code'

5. 或者在 VS Code 中通过 File > Open Folder... 选择 ~/projects/hello-go 目录。
6. 编写代码: 打开 main.go 文件，输入以下代码：

package main // 声明这个文件属于 main 包，是可执行程序的入口
import "fmt" // 导入 fmt 包，用于格式化输入输出
// main 函数是程序的入口点
func main() {
  message := "Hello, Go World! from VS Code on macOS!" // 使用短变量声明
  fmt.Println(message) // 打印消息到控制台
}

5. 当你保存文件时，如果 Go 扩展和 gopls 工作正常，它可能会自动格式化代码并添加/删除 import 语句。
6. 运行程序:
7. 方法一：在 VS Code 集成终端中运行
8. 打开 VS Code 的集成终端 (Terminal > New Terminal 或 `Ctrl + ``)。
9. 确保终端的当前目录是你的项目目录 (~/projects/hello-go)。
10. 输入命令：

go run main.go

5. 你应该能在终端看到输出：Hello, Go World! from VS Code on macOS!

6. 方法二：构建并运行可执行文件
7. 在终端输入：

go build

5. 这会在当前目录下生成一个名为 hello-go (与你的模块名或目录名相关) 的可执行文件。
6. 运行这个文件：

./hello-go

5. 同样会看到输出。
6. 方法三：使用 VS Code 的运行和调试功能 (F5)
7. 打开 main.go 文件。
8. 直接按 F5 (或者去 "Run" 菜单选择 "Start Debugging")。
9. VS Code 可能会询问你创建 launch.json 文件（用于配置调试），通常选择默认的 Go 配置即可。
10. 程序会在 "DEBUG CONSOLE" 面板中运行，并输出结果。你还可以在代码中设置断点进行调试。

总结

现在，你的 macOS 上已经成功安装了 Go 语言环境，并且 VS Code 也配置好了 Go 开发所需的扩展和工具。你已经能够创建、编译和运行一个简单的 Go 程序了。

后续建议:

• 熟悉 VS Code 的 Go 扩展提供的功能：代码补全、跳转定义、查找引用、重构、调试等。
• 开始学习 Go 的基础语法（变量、类型、流程控制、函数、包等）。
• 多动手实践，尝试写更多的小程序。

祝你学习 Go 语言愉快！