windows上用msi安装go最可靠，自动配置bin路径、path和goroot；装完重启命令行运行go version验证，再配vs code官方插件及gopls、delve等工具即可开发。
Go 环境能跑 go run 和 go build，编辑器能跳转定义、补全函数、保存自动格式化——这就算搭成了。其余都是锦上添花，不是门槛。
Windows 上用 .msi 安装包是最少出错的方式
别手动解压 go1.21.6.windows-amd64.zip 再配 GOROOT 和 PATH。官方 .msi 安装程序会自动完成三件事：把 go.exe 放进 C:\Program Files\Go\bin、把该路径加进系统 PATH、设置好 GOROOT。装完直接开命令行输 go version，有输出就说明基础环境通了。
容易踩的坑：
- 装完没重启命令行或 PowerShell，
go命令仍报“不是内部或外部命令”——关掉重开 - 同时装了多个 Go 版本（比如通过
gvm或asdf），go version显示的不是你刚装的那个——用where go查实际调用路径 - 杀毒软件（尤其是某些国产全家桶）会拦截
go install下载工具，表现为Go: Install/Update Tools卡住或失败——临时禁用再试
VS Code + 官方 Go 插件是当前最稳的组合
不用折腾 gocode、godef 这些老工具。VS Code 官方插件（ID：golang.go）默认启用 gopls 语言服务器，它统一处理补全、跳转、诊断、重命名等所有智能功能。只要 gopls 能启动，其他都顺带好了。
实操建议：
- 装完插件后，打开一个
.go文件，VS Code 右下角会弹提示“检测到 Go 模块，是否安装工具？”，点“全部安装”——重点确保gopls、delve、goimports进去 - 在用户设置里加这三行，避免格式化和导入管理不一致：
"editor.formatOnSave": true,<br>"go.formatTool": "goimports",<br>"go.useLanguageServer": true
- 如果
Ctrl+Click跳不到定义，先运行命令面板（Ctrl+Shift+P）→Go: Restart Language Server，比重装插件快得多
GO111MODULE=on 现在是默认行为，但得确认没被覆盖
Go 1.16+ 默认开启模块模式，意味着你不需要 GOPATH 就能 go mod init。但有些旧脚本、IDE 配置或公司内网策略会显式设 GO111MODULE=off，导致 go get 仍往 $GOPATH/src 写，或者 go build 找不到依赖。
验证和修复方法：
- 终端执行
go env GO111MODULE，输出必须是on；如果是auto或off，就说明被覆盖了 - 检查是否在系统环境变量、PowerShell 配置文件（
$PROFILE）、或 VS Code 的settings.json里写了GO111MODULE=off—— 直接删掉 - 国内开发者务必配代理，否则
gopls启动时卡在拉golang.org/x/tools：go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=off
不要为 GOPATH 花太多时间
模块模式下，GOPATH 只影响两件事：你手动 go install 的二进制放哪（$GOPATH/bin），以及 go get 在非模块项目里的下载位置。绝大多数情况，你只需要确保 $GOPATH/bin 在 PATH 里，这样 dlv、stringer 这类工具才能被命令行直接调用。
建议做法：
- 保持
GOPATH为默认值（Windows 是%USERPROFILE%\go，macOS/Linux 是$HOME/go） - 别把它和项目目录混在一起——你的项目可以放在
D:\myproject，完全不用进$GOPATH/src - 如果某工具报错说“找不到 $GOPATH”，不是你没设，而是它本身太老，不支持模块——换用新版替代品（比如用
gofumpt替goimport）
真正容易被忽略的是：VS Code 的集成终端和外部终端的环境变量可能不一致。你在外面 go env 看着都对，但 F5 调试时 delve 启动失败——这时候要检查 VS Code 设置里的 terminal.integrated.env.* 是否覆盖了关键变量。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
