Go开发环境搭建需正确配置PATH、GOPROXY和GO111MODULE，禁用GOPATH依赖，新建模块用go mod init，避免在$GOPATH/src下创建项目，推荐VS Code+gopls组合。
Go 语言开发环境搭建本身不复杂，但容易在 GOPATH、GOBIN、模块模式与 go install 行为上踩坑，尤其当你混用老项目（依赖 vendor）和新模块项目时。
下载安装 Go 并验证版本
从官网 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统安装包（macOS 推荐 .pkg，Linux 推荐 tar.gz），安装后必须验证是否生效：
go version
输出应类似 go version go1.22.3 darwin/arm64。若提示 command not found: go，说明 PATH 未正确配置——macOS/Linux 检查 ~/.zshrc 或 ~/.bash_profile 是否添加了 export PATH=$PATH:/usr/local/go/bin；Windows 则需在「系统属性 → 高级 → 环境变量」中确认 Path 包含 C:\Go\bin。
初始化 GOPROXY 和启用模块模式
国内直连 proxy.golang.org 常失败，必须设置代理；同时 Go 1.16+ 默认启用模块（module）模式，但部分旧脚本仍隐式依赖 GOPATH，建议显式关闭兼容路径干扰：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct - 运行
go env -w GO111MODULE=on（强制开启模块，避免因目录位置触发自动降级） - 不必再手动设置
GOPATH：现代 Go 已默认使用$HOME/go，且仅用于存放pkg、bin和全局缓存，项目根目录无需在GOPATH内
创建第一个模块并运行
新建任意空目录（如 ~/hello），执行：
go mod init hello
echo 'package main\n\nimport "fmt"\n\nfunc main() { fmt.Println("Hello, Go!") }' > main.go
go run main.go
关键点：
-
go mod init会生成go.mod，模块名不一定要是域名，本地练习用hello完全合法 - 不要在
$GOPATH/src下创建项目——这是旧模式残留习惯，现在会导致go run报cannot find module providing package - 如果看到
go: downloading ...日志，说明代理生效；若卡住，检查go env GOPROXY输出是否正确
配置常用工具链（可选但推荐）
VS Code + gopls 是目前最稳的组合。安装 VS Code 后，装官方 Go 插件（由 golang.org/x/tools 提供），它会自动下载 gopls（Go language server）。若手动安装：
go install golang.org/x/tools/gopls@latest
注意：go install 默认把二进制写入 $HOME/go/bin，确保该路径已在 PATH 中，否则 VS Code 找不到 gopls。另外，禁用 go.gopath 相关设置（如 "go.gopath" 字段），现代开发已无需手动指定 GOPATH。
真正容易被忽略的是：每次新开终端后，go env 设置是否持久生效；以及 go run 和 go build 对当前目录的模块感知是否一致——它们都依赖 go.mod 是否存在，而不是路径深度或父目录结构。
