Go开发环境可用需满足三个核心条件：PATH正确配置使go命令可识别、GOPROXY设为国内镜像（如https://goproxy.cn）解决模块下载超时、VS Code中gopls等工具安装并启用语言服务器；三者任一缺失均会导致典型问题。
go version 能跑出来，go mod init 能成功生成 go.mod，说明 Golang 开发环境已经可用——绝大多数人卡在 PATH 没配对、代理没设好、或 VS Code 没装对插件这三步上。
go 命令找不到？PATH 配错了最常见
不是 Go 没装，而是 shell 找不到 go 二进制文件。Windows 的 .msi 安装器默认加了 PATH，但 macOS/Linux 经常漏掉这步。
- 先确认
go文件真实存在：ls -la /usr/local/go/bin/go（macOS/Linux）或dir "C:\Program Files\Go\bin\go.exe"（Windows） - 再检查 PATH 是否包含该路径：
echo $PATH（macOS/Linux）或echo %PATH%（Windows） - 如果没出现，手动补上：
export PATH=$PATH:/usr/local/go/bin（写进~/.zshrc或~/.bashrc），然后source ~/.zshrc - Windows 用户注意：修改环境变量后，必须重启终端（CMD/PowerShell）才生效，旧窗口不认新 PATH
go mod init 失败报“no module found”或 timeout？代理没开
Go Modules 默认直连 proxy.golang.org，国内访问极慢甚至超时。这不是网络问题，是 Go 工具链默认没走代理。
- 执行这条命令启用国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果仍失败，检查是否被公司防火墙拦截——可临时加
-insecure参数测试（仅限内网可信环境）：go mod init myapp -insecure - VS Code 中的
gopls也依赖这个代理，没设好会导致代码提示卡死或不全
VS Code 写 Go 代码没提示、不能跳转？插件和工具链没联动
装了 Go 插件不等于装好了工具链。VS Code 提示“Install All Tools”时点确定，但部分工具（如 gopls、dlv）可能因代理问题静默失败。
- 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），运行Go: Install/Update Tools - 勾选全部工具，尤其是
gopls（语言服务器）和dlv（调试器），点击 OK - 若安装卡住，终端手动装：
GO111MODULE=on go install golang.org/x/tools/gopls@latest - 检查设置里是否启用了语言服务器：
"go.useLanguageServer": true（在settings.json中） - 重启 VS Code —— 插件不会自动 reload 语言服务器进程
项目跑起来但热更新失效？别用 go run 硬 reload
go run main.go 是一次性执行，改完代码必须手动 Ctrl+C 再重跑。这不是环境问题，是开发流没配对。
立即学习“go语言免费学习笔记（深入）”；
- 简单替代：
go build -o app && ./app，配合文件监听工具（如air或fresh） - 装
air：go install github.com/cosmtrek/air@latest，然后项目根目录下直接运行air - 注意
air默认监听.go文件，若你用了.tmpl或.yaml配置，需在.air.toml里显式添加watch_ext = ["go", "yaml", "tmpl"] - Docker 开发场景下，别在容器里跑
air—— bind mount + inotify 在 Linux 容器里通常正常，但在 macOS 上需加consistency: cached才不丢事件
