go命令未找到是path配置问题，非未安装；vs code中gopls缺失需手动安装并配置路径；go项目必须初始化模块且module名合法，否则后续命令全部失败。
go version 没输出或报 command not found
说明 go 命令没进系统 PATH，不是“没装好”，而是 shell 找不到它。
macOS 上安装.pkg 默认把 /usr/local/go/bin 加进 PATH，但前提是你的 shell 是 zsh（默认）且没覆盖 $PATH。如果用的是 fish、bash 或自定义了 ~/.zshrc，很可能被清空或重写过。
- 运行
ls /usr/local/go/bin/go确认文件存在 - 检查当前 shell：
echo $SHELL；如果是 zsh，执行cat ~/.zshrc | grep PATH - 若无
/usr/local/go/bin，在~/.zshrc末尾加一行：export PATH="/usr/local/go/bin:$PATH" - 执行
source ~/.zshrc，再试go version
Windows 用户常见问题是安装时勾选了“Add to PATH”但重启终端前就测试——必须新开一个 PowerShell 或 CMD 窗口。
VS Code 的 Go 扩展提示 “gopls not found”
gopls 是 Go 官方语言服务器，VS Code 的智能提示、跳转、格式化全靠它。插件会自动尝试安装，但经常失败，原因很具体：
- 网络策略拦截：国内访问
golang.org域名不稳定，go install golang.org/x/tools/gopls@latest直接卡住 - Go 版本太旧：1.18 以下不支持模块感知的
gopls，建议用go1.22.5或更新 - 没设
GOBIN：工具默认装到$GOPATH/bin，但 VS Code 可能没读到该路径
手动装最稳：go install golang.org/x/tools/gopls@latest
然后在 VS Code 设置里搜 go.goplsPath，填入 $HOME/go/bin/gopls（macOS/Linux）或 %USERPROFILE%\go\bin\gopls.exe（Windows）。
新建 main.go 后左下角不显示 Go 图标
这不是扩展没装，而是 VS Code 没识别出这是 Go 工作区。它依赖两个信号：
- 文件后缀是
.go（满足） - 当前打开的文件夹里有
go.mod，或在GOPATH/src/xxx下（旧模式）
现代项目强烈建议直接初始化模块：mkdir myproject && cd myprojectgo mod init example.com/myproject
再用 VS Code 打开这个文件夹，而不是只打开单个 main.go 文件。
如果仍不生效，右键编辑器空白处 → “Open Folder”，确保整个目录被加载，而非仅文件。
go run main.go 报错 “cannot find module providing package …”
这是 Go Modules 的典型报错，意味着当前目录不在模块根下，或 go.mod 损坏。
- 先确认是否在模块目录里：
ls go.mod，没有就go mod init xxx - 如果已有
go.mod但内容为空或只有module行，删掉重来 - 别在
$GOPATH/src外随便建文件——Go 1.16+ 默认启用 Modules，不再强制要求 GOPATH 结构 - 临时绕过：加
-mod=mod参数，如go run -mod=mod main.go，但这只是掩耳盗铃
真正要盯住的，是 go.mod 第一行的 module 名是否合法（不能含大写字母、空格、下划线），比如 module my-project 就非法，得改成 module myproject 或 module github.com/you/myproject。
模块初始化和 go.mod 的命名规则，是新手最容易忽略却导致后续所有命令失效的点。一旦模块名写错，go get、go build 全部连锁失败，但错误信息从不直说“你 module 名错了”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
