go version无响应是因path未包含goroot/bin；go mod init报错因项目位于gopath/src内或gopath干扰；vs code import标红因gopls未安装；go run报错因缺少或损坏go.mod文件。
go version 命令没反应，PATH 没配对
安装完 Go 后执行 go version 报错“command not found”或直接无输出，说明系统根本找不到 go 二进制文件。这不是 Go 没装好，而是 PATH 没指向 GOROOT/bin。
- Windows 用户：检查“系统变量”里的
Path，确认是否添加了类似C:\Go\bin的路径（默认安装路径）；别漏掉bin目录本身 - macOS/Linux 用户：在终端运行
echo $PATH，看输出里有没有/usr/local/go/bin或你自定义的$GOROOT/bin；如果没出现，说明export PATH=$PATH:/usr/local/go/bin这行没生效，要确认改的是当前 shell 的配置文件（~/.zshrc还是~/.bash_profile），然后执行source ~/.zshrc - 别用
sudo go version来“绕过”——这只会掩盖 PATH 问题，且可能调用到系统自带的旧版go（比如 Ubuntu 自带的golang-go包），版本往往滞后
go mod init 报错 “cannot determine module path”，GOPATH 还在干扰
新建项目后执行 go mod init myapp 提示 “cannot determine module path”，常见于两种情况：当前目录在 GOPATH/src 下，或 GOPATH 被设成某个子目录但没遵循传统结构。
- Go 1.11+ 默认启用模块模式，
GOPATH不再决定项目位置；建议彻底不设GOPATH，或只设为一个干净目录（如$HOME/go-workspace），且**不要把项目放在$GOPATH/src里** - 项目可建在任意路径，比如
~/projects/myapp，只要不在GOPATH树内就行；初始化时显式指定模块名：go mod init github.com/yourname/myapp，避免依赖路径推导 - 如果已误建在
$GOPATH/src，删掉整个项目再重建，别试图“修复”——模块路径混乱后，go get和go build行为会不可预测
VS Code 里 import 提示红色波浪线，gopls 没起来
写 import "fmt" 却标红、没自动补全、Ctrl+Click 进不去源码，大概率是 gopls（Go 语言服务器）没正常启动，而不是代码或环境变量问题。
- 先确认 VS Code 已安装官方
Go扩展（publisher:golang.go），不是第三方“Go for Visual Studio Code”之类的老插件 - 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），运行Go: Install/Update Tools，勾选全部，尤其是gopls—— 它不会随扩展自动装，必须手动触发 - 如果提示 “failed to install gopls”，检查代理设置：
go env -w GOPROXY=https://proxy.golang.org,direct（国内用户建议换为https://goproxy.cn） - 重启 VS Code，再看右下角状态栏是否有
gopls正在加载的提示；没有就打开输出面板（View → Output），选择 “Go” 查看具体错误
go run main.go 报错 “no required module provides package”，go.mod 丢失或损坏
项目目录下有 main.go，但执行 go run main.go 提示找不到包，说明 Go 认为这不是一个模块，或 go.mod 文件内容异常。
- 最简解法：删掉当前目录下的
go.mod和go.sum，重新运行go mod init example.com/myapp（模块名随意，只要合法即可） - 别手动编辑
go.mod添加require行——初学者容易写错格式或版本号，导致解析失败；所有依赖应通过go get或go run自动触发添加 - 如果项目根目录下没有
go.mod，go run会退回到 GOPATH 模式，而现代 Go 默认禁用该模式，直接报错；所以go mod init是每个新项目的必做第一步
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
