先确认go命令是否就绪：执行which go或go version，若报“command not found”，说明/usr/local/go/bin（linux/macos）或%goroot%\bin（windows）未加入path，需补入并重启终端；验证通过后方可进行后续gopls、dlv等工具安装与vs code配置。
go 命令本身是否已就绪？先确认二进制路径
很多问题其实卡在 go 命令根本找不到——不是没装，而是 /usr/local/go/bin 没进 PATH。执行 which go 返回空，或 go version 报 “command not found”，基本就是这个原因。
检查方式：echo $PATH 看输出里有没有 /usr/local/go/bin（Linux/macOS）或 C:\Program Files\Go\bin（Windows）。没有就补：
- Linux/macOS：往
~/.bashrc或~/.zshrc末尾加export PATH=$PATH:/usr/local/go/bin - Windows：在系统环境变量里把
%GOROOT%\bin加到PATH，注意GOROOT要指向实际安装目录 - 改完别忘
source ~/.zshrc（或重启终端），再试go version
GOPATH 和 Go Modules 怎么设才不冲突？
Go 1.16+ 默认启用模块（GO111MODULE=on），GOPATH 不再是必须项，但仍有用途：存放 go install 安装的工具二进制文件（比如 gopls、dlv）。所以建议保留，但不必强求项目放里面。
典型安全配置：
-
export GOPATH=$HOME/go（推荐，避免权限问题） -
export PATH=$PATH:$GOPATH/bin（让go install的工具可直接调用） -
go env -w GO111MODULE=on（强制模块模式，避免go.mod被忽略） -
go env -w GOPROXY=https://goproxy.cn,direct（国内必须，否则go mod download极慢或失败）
⚠️ 注意：GOPATH 和项目目录无关——你完全可以在任意路径下 go mod init myapp，只要 go 命令能跑通就行。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
哪些开发工具属于“开箱即用”必备项？
不是所有工具都得装，但以下三个是日常编码绕不开的：
-
gopls：Go 官方语言服务器，VS Code / GoLand 依赖它提供跳转、补全、诊断。安装命令：go install golang.org/x/tools/gopls@latest -
dlv：调试器，go run或 IDE 断点调试全靠它。go install github.com/go-delve/delve/cmd/dlv@latest -
gofmt或goimports：格式化工具，gofmt内置，goimports更智能（自动增删 import）。VS Code 的 Go 插件默认调用它们
装完验证：gopls version、dlv version 有输出即成功。如果提示 “command not found”，说明 $GOPATH/bin 没进 PATH，回第一部分检查。
VS Code 配置里最容易漏掉的关键项
装了 Go 插件 ≠ 自动好用。常见失效场景是插件找不到 gopls 或用错 Go 版本。
手动检查点：
- 打开 VS Code 设置（
Cmd+,或Ctrl+,），搜go.gopath，确认值是$HOME/go（或你设的GOPATH） - 搜
go.goroot，确保指向/usr/local/go（Linux/macOS）或C:\Program Files\Go（Windows） - 搜
go.useLanguageServer，必须为true；否则补全和诊断基本瘫痪 - 新建一个
main.go，如果左下角状态栏没显示 “gopls” 连接成功，点开 Output 面板选 “Go” 查日志，大概率是gopls路径不对或版本太旧
真正麻烦的不是装，而是各环节路径对不上——go、gopls、dlv 各自认的 GOPATH 和 GOROOT 必须一致，否则编辑器里看着正常，终端里 go run 却报错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
