VSCode中Go插件无补全、go run失败、gopls报错，根本原因是GOROOT/GOPATH未对齐或缺失go.mod：需验证终端与VSCode内建终端中go路径一致，项目根目录执行go mod init生成go.mod，并清空手动配置的go.gopath等冗余项。
VSCode 里装完 Go 插件却没补全、不识别 go run、gopls 报错 —— 不是插件问题，而是 GOROOT 和 GOPATH 没对齐，或模块初始化缺失。直接按下面三步做，90% 的环境卡点能当场解决。
确认 go 命令在终端可用且路径正确
VSCode 的 Go 插件底层依赖系统 PATH 中的 go 可执行文件。如果终端里能跑 go version，但 VSCode 里提示 “Command 'go' not found”，说明 VSCode 没读到 shell 的环境变量。
- macOS / Linux：检查
~/.zshrc（或~/.bash_profile）是否包含export PATH=$PATH:/usr/local/go/bin（或你实际的GOROOT下的bin路径），然后运行source ~/.zshrc - Windows：确认系统环境变量
PATH包含C:\Program Files\Go\bin（或你安装路径下的bin） - VSCode 必须重启（不是 reload window），否则不会重载 shell 环境
- 验证方式：在 VSCode 内置终端（
Ctrl+`）中执行which go或where go，输出应与终端一致
初始化 Go Modules 并确保 go.mod 存在
Go 1.16+ 默认启用 modules，VSCode 的 gopls（语言服务器）必须基于 go.mod 文件工作。空目录或仅有一个 .go 文件但没模块声明，会导致补全失效、跳转失败、依赖不识别。
- 进项目根目录，执行
go mod init example.com/myapp（模块名可任意，只要符合域名格式） - 立刻生成
go.mod文件，内容至少含module和go版本行 - 不要手动创建
go.mod文件 ——go mod init会自动处理 checksum 和版本兼容性 - 若已有旧项目用
GOPATH方式组织，先cd进src/下对应包路径，再go mod init，避免路径冲突
VSCode 中禁用冗余配置项，只保留必要设置
新版 VSCode Go 插件（v0.38+）已默认自动发现 GOROOT 和 GOPATH，手动填 go.gopath 或 go.toolsGopath 反而容易覆盖自动推导，引发工具链错位。
立即学习“go语言免费学习笔记（深入）”；
- 打开设置（
Cmd+,），搜索go.gopath→ 清空该字段（设为undefined） - 同样清空
go.toolsGopath；插件会从go env GOPATH自动读取 - 确认
go.useLanguageServer为true（默认开启，禁用则失去补全/诊断能力） - 如仍报
gopls启动失败，在命令面板（Cmd+Shift+P）运行Go: Install/Update Tools，勾选gopls单独重装
最常被忽略的是：VSCode 内置终端启动时未继承 shell 配置，导致 go 可执行路径缺失；其次是新建项目忘了 go mod init，让 gopls 失去上下文。这两点卡住，装再多个插件也没用。
