环境搭好的核心标志是：能直接运行go version、go mod tidy自动拉包、VS Code中Ctrl+点击跳转到fmt.Println；若go version报错需重开终端并检查PATH；国内需配置GO111MODULE=on和GOPROXY=https://goproxy.cn,direct；VS Code跳转失效常因gopls未安装或缺失go.mod文件。
能直接运行 go version、go mod tidy 自动拉包、VS Code 里按 Ctrl+点击能跳转到 fmt.Println ——这三件事成了，环境就算搭好了。其他花哨功能都是后话。
go version 报“不是内部或外部命令”？关掉所有终端重开
Windows 下用 .msi 安装包，PATH 确实会自动写入，但系统不会把新变量“广播”给已打开的 CMD/PowerShell 窗口。这不是装错了，是变量没加载。
- 必须关闭所有已打开的终端窗口，再全新启动一个
- 验证方式：执行
where go，应返回类似C:\Go\bin\go.exe的路径 - 如果仍失败，检查系统环境变量
Path是否包含C:\Go\bin（或你自定义的安装路径下的\bin） - 别试
go --version——旧版 Go 不认这个参数，只认go version
go run main.go 成功，但加 import 第三方库就报错？GO111MODULE 和 GOPROXY 没生效
Go 1.16+ 默认开启模块管理，但国内不配代理，go get 或 go mod tidy 基本必卡在 proxy.golang.org 超时。
- 执行这三条命令（永久写入）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
direct很关键：当镜像没同步到最新包时，会自动 fallback 到官方校验，避免checksum mismatch - 验证：运行
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux），输出应为配置值 - 别手动改
go.env文件 —— 用go env -w才能保证格式和优先级正确
VS Code 提示“install tools”点完还是没补全？gopls 没装成或没识别模块路径
VS Code 的 Go 插件依赖 gopls（Go language server）提供跳转、补全、诊断等功能。点“Install All”失败，大概率是网络问题或路径错乱。
立即学习“go语言免费学习笔记（深入）”；
- 先确认
GOPROXY已配置（见上一条），再在 VS Code 内置终端中手动运行：go install golang.org/x/tools/gopls@latest - 安装成功后，
gopls二进制会落在$GOPATH/bin/gopls（Go 1.21+ 默认$GOPATH是$HOME/go） - 重启 VS Code，或按
Ctrl+Shift+P→ 输入Developer: Reload Window - 如果仍提示找不到工具，检查当前项目根目录下是否有
go.mod；没有就先执行go mod init example.com/hello（名字随意，合法即可）
go mod init 该填什么？填错会立刻影响本地运行吗？
模块名只是将来别人 import 你代码时的路径前缀，跟能否跑起来完全无关。但它一旦提交到仓库，改起来就麻烦。
- 本地练习：填
go mod init hello完全没问题，go run照常工作 - 准备推 GitHub：建议一步到位填完整路径，比如
go mod init github.com/yourname/myapp - 别用
go mod init .—— 自动推导失败率高，尤其目录名含中文、空格或特殊符号时直接报错 - 模块名不必和文件夹名一致，但保持一致能减少协作时的理解成本；
go mod tidy不会帮你改模块名，只管依赖
最容易被忽略的其实是路径合法性：Windows 记事本保存的 .go 文件可能带 BOM 头，macOS Finder 新建的文件夹名带空格，Linux 终端里用了中文路径——这些都会让 go mod 直接拒绝工作，且错误信息非常模糊。动手前先看一眼当前目录名和文件编码。
