真正可用的标志是三件事同时成立：go run main.go能输出结果、go mod init能生成go.mod、vs code能跳转到fmt.println定义；缺一不可。
装完 Go 不等于环境就 ready 了，go version 成功只是起点；真正可用的标志是三件事同时成立：go run main.go 能输出结果、go mod init 能生成 go.mod、VS Code（或你用的编辑器）能跳转到 fmt.Println 的定义。缺一不可。
go version 成功但命令仍报 “not found”？检查 PATH 是否真正生效
Windows 用户最常卡在这一步：.msi 安装包确实写了 Path，但已打开的 CMD/PowerShell 不会自动重载系统变量。必须关闭所有终端窗口，新开一个再试。
- 验证方式不是看安装记录，而是执行
where go（Windows）或which go（macOS/Linux），输出必须是类似C:\Go\bin\go.exe或/usr/local/go/bin/go - 如果返回空，说明
Path没生效；如果返回的是旧路径（比如C:\Program Files\Go\bin\go.exe），注意空格会导致后续go build失败，建议重装到D:\Go这类扁平路径 - macOS/Linux 用户若用 zsh，改完
~/.zshrc后别忘了source ~/.zshrc，否则go命令依然找不到
go run 成功，但加 import 就报 “cannot find package”？GO111MODULE 和 GOPROXY 没配对
Go 1.16+ 默认启用模块，但国内不配代理几乎必失败——go get 卡住、go mod download 超时、VS Code 补全标红，根源都在这儿。
- 必须运行这三条（永久写入）：
go env -w GO111MODULE=on、go env -w GOPROXY=https://goproxy.cn,direct、go env -w GOSUMDB=sum.golang.org direct -
direct很关键：当镜像没同步到最新版时，会自动回源校验，避免因哈希不匹配导致下载中断 - 验证是否生效：
go env | grep GOPROXY（macOS/Linux）或go env | findstr GOPROXY（Windows），输出必须含https://goproxy.cn - PowerShell 和 CMD 环境变量作用域不同，建议统一用 PowerShell 执行
go env -w，避免跨终端失效
VS Code 提示 “install tools” 但补全/跳转始终不工作？gopls 没装对或没识别 module 根
不是插件没点“全部安装”，而是 gopls 这个语言服务器根本没启动成功。它依赖模块路径解析，一旦项目根目录没被识别，整个智能功能就瘫痪。
- 先确保当前目录下有
go.mod（由go mod init myapp生成），且没有同级的go.work文件干扰 - 在 VS Code 内置终端里手动运行：
go install golang.org/x/tools/gopls@latest（注意是@latest，不是@master） - 安装完必须重启窗口：
Ctrl+Shift+P→ 输入Developer: Reload Window，只重载不等于重连gopls - 右下角状态栏要显示
gopls (running)和模块名（如myapp），才说明加载成功；如果显示no module，说明打开的不是项目根目录
go mod init 后 import 本地子包仍标红？package 名和目录结构不匹配
Go 不靠文件夹名推断包名，而是读 package xxx 声明。子目录里没 .go 文件、或包名写成 main、或目录名含大写字母，都会让 go list ./... 失败。
- 想引入
./utils，先确保该目录下至少有一个.go文件，且第一行是package utils（不能是package main） - 模块名（
go mod init xxx中的xxx）不能含大写字母或空格，否则go build直接报invalid module path - 验证子包是否被识别：在项目根目录下运行
go list ./utils，能输出路径才说明可导入；如果报no matching packages，八成是utils/下没有合法的package声明 - 别用
go mod edit修混乱的go.mod，直接删掉重来更可靠
最容易被忽略的是：Go 1.22+ 已彻底弃用 GOPATH 强制路径约束，但很多人仍习惯把项目塞进 ~/go/src/xxx，结果 go mod init 生成的模块路径和实际 import 不一致，导致 IDE 无法解析。记住——项目可以建在任何地方，只要 go.mod 在根，gopls 就能认出来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
