Go开发环境搭建关键在正确配置PATH、理解GOPATH与模块关系、安装gopls和dlv工具、用go mod init初始化项目；go run可直接运行无需先build，依赖自动管理。
Go 开发环境搭建本身不复杂，但容易在 GOPATH、GOBIN、模块初始化和 IDE 集成这几个环节出问题，尤其当你同时用多个 Go 版本或混用 go mod 与旧式 GOPATH 工作流时。
下载安装 Go 并验证版本
从官网（https://go.dev/dl/）下载对应操作系统的二进制包，解压后把 bin 目录加入 PATH。macOS 用户若用 Homebrew，执行 brew install go 即可。
安装后务必运行：
go version
确认输出类似 go version go1.22.3 darwin/arm64。如果报 command not found: go，说明 PATH 没配对——常见错误是改了 shell 配置文件（如 ~/.zshrc）但没执行 source ~/.zshrc 或新开终端。
立即学习“go语言免费学习笔记（深入）”；
理解 GOPATH 和 Go Modules 的关系
Go 1.11+ 默认启用模块（go mod），GOPATH 不再是必须项。但很多老教程仍强调设置它，导致新手误以为“不设 GOPATH 就不能写代码”。
- 如果你只写新项目（有
go.mod文件），GOPATH可以完全不管；go命令会自动在当前目录找go.mod，找不到就向上递归 -
GOPATH现在主要用于存放go install安装的可执行工具（如gopls、delve），默认路径是$HOME/go - 若要显式设置，推荐只设
GOPATH，不要动GOROOT（除非你手动编译了 Go 源码）
配置 VS Code + gopls 进行开发
VS Code 是目前最主流的 Go IDE，核心依赖 gopls（Go Language Server）。它不是插件自带的，必须手动安装：
go install golang.org/x/tools/gopls@latest
执行完后检查是否成功：
which gopls
应输出类似 /Users/xxx/go/bin/gopls。然后在 VS Code 中安装官方 “Go” 扩展（由 Go team 维护），扩展会自动检测 gopls 路径。
常见卡点：
-
gopls启动失败：多数因 Go 版本太低（goplsv0.14+ 要求 Go ≥ 1.20） - 代码补全无效：检查当前工作区是否在 module 根目录（即含
go.mod），否则gopls会退化为 GOPATH 模式并报错 - 调试断点不命中：确保已安装
dlv（go install github.com/go-delve/delve/cmd/dlv@latest），且 VS Code 的launch.json中dlvLoadConfig配置合理
初始化一个可运行的模块项目
别急着写 main.go，先初始化模块：
mkdir hello && cd hello<br>go mod init hello
这会在当前目录生成 go.mod，内容类似：
module hello<br><br>go 1.22
然后创建 main.go：
package main<br><br>import "fmt"<br><br>func main() {<br> fmt.Println("Hello, Go")<br>}
运行：go run main.go。注意：此时不用 go build 再 ./hello，go run 会自动解析 go.mod 并处理依赖。
如果项目后续要引入第三方包（比如 github.com/spf13/cobra），直接在代码里 import，然后运行 go run 或 go build，Go 会自动写入 go.mod 和 go.sum —— 不需要手动 go get（除非你想预下载）。
模块路径名（go mod init xxx 中的 xxx）不必是真实域名，本地练习用 hello 完全合法；只有将来要发布到公共仓库时，才建议用 github.com/yourname/hello 这类格式。
