Go环境是否装对，关键看go version、$GOROOT和$GOPATH是否合理；VS Code中gopls是语言功能核心，需手动安装并配置路径，且拼写提示依赖module和staticcheck配合。
Go 环境是否装对了，关键看 go version 和 $GOROOT、$GOPATH 是否合理
很多人执行 go version 能看到输出就以为装好了，但后续 go build 报 cannot find module for path 或 import "xxx" not found，往往是因为没设对 $GOROOT（Go 安装根目录）或依赖模块路径混乱。macOS/Linux 下建议用官方二进制包安装（非 Homebrew），避免版本和路径被覆盖；Windows 用户务必检查系统环境变量里 GOROOT 指向的是你解压的 go 目录（如 C:go），且 PATH 包含 %GOROOT%in。
Go 1.16+ 默认启用 module 模式，$GOPATH 不再强制用于存放源码，但 go mod init 前仍需确保当前目录在 GOPATH 外（比如放在 ~/projects/myapp），否则可能触发 legacy mode 行为。验证方式：运行 go env GOROOT GOPATH，确认输出路径存在且可读。
VS Code 中启用 gopls 是拼写检查（及所有 Go 语言功能）的前提
VS Code 的 Go 插件（由 Go Team 官方维护）不再支持旧版 guru 或 go-outline，全部能力由 gopls（Go language server）提供——包括变量名拼写提示、未使用变量警告、fmt.Sprintf 参数类型不匹配等静态检查。它不是“拼写检查插件”，而是整个语言智能的核心。
常见问题：
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 装了 Go 插件但没反应？检查是否禁用了
gopls：Settings → Extensions → Go → Use Language Server必须勾选 -
gopls启动失败？运行go install golang.org/x/tools/gopls@latest手动安装，并在设置中指定路径："go.goplsPath": "/home/you/go/bin/gopls"（Linux/macOS）或"go.goplsPath": "C:\Users\you\go\bin\gopls.exe"（Windows） - 打开单个
.go文件无提示？gopls需要识别 module；确保目录下有go.mod，或右键文件选择Go: Initialize Module
gopls 默认不检查未导出标识符拼写，需手动开启 semanticTokens 和调整 diagnostics
默认情况下，gopls 对函数内变量名（如 usreName 拼错）会标黄警告，但对未导出的结构体字段（如 type User struct { namme string }）或局部常量，可能完全不报——这不是 bug，是设计上减少噪音。真要严格检查所有拼写，得改 VS Code 设置：
{
"go.languageServerFlags": [
"-rpc.trace",
"-mode=semantic"
],
"go.diagnostics.staticcheck": true,
"go.toolsEnvVars": {
"GOFLAGS": "-mod=readonly"
}
}
更关键的是启用 staticcheck（一个独立的 Go 静态分析工具），它比 gopls 自带检查更细粒度。运行 go install honnef.co/go/tools/cmd/staticcheck@latest，然后在设置里打开 go.enableStaticcheck。它能捕获 unexported field name typo 类错误，但代价是 CPU 占用略高，大型项目建议只在保存时运行（设置 go.lintOnSave 为 "file"）。
别指望 IDE 自动修拼写错误，gopls 只提示，重命名必须用 Refactor → Rename
拼写错误（比如把 username 写成 useername）在编辑器里只会标黄或波浪线，不会自动替换。想批量修正，必须右键变量 → Refactor → Rename（快捷键通常是 F2），gopls 会安全地重命名所有引用——这是唯一可靠方式。直接 Ctrl+H 全局替换风险极高：可能误改字符串字面量、注释、或其它包里的同名标识符。
另外注意：gopls 的重命名只作用于当前 module 内。如果跨 module 引用了你的包，且对方用的是老式 vendor 或未更新的 tag，重命名后对方构建会失败，得同步发新版并通知调用方升级。
拼写检查本身不难配，难的是理解 gopls 和 staticcheck 的职责边界，以及 module 路径、环境变量、语言服务器启动状态这三者怎么咬合。随便改一个，其他两个就容易掉链子。
