go命令报command not found的根本原因是goroot/bin未加入path环境变量，需手动将go安装路径（如/usr/local/go/bin或c:\go\bin）添加到系统path，并重新加载shell配置或重启终端。
go 命令根本跑不起来，后续所有开发都卡在第一步。这不是“要不要学”的问题，而是“没搭好就写不了任何东西”的硬门槛。
go version 报 command not found 怎么办
这是最常见也最基础的失败信号，本质是系统找不到 go 可执行文件。根本原因不是没装 Go，而是没把 GOROOT/bin 加进 PATH。
- Windows 用户装完 .msi 后默认会自动配置 PATH，但如果你用的是 zip 手动解压方式，必须手动把
C:\Program Files\Go\bin（或你解压的实际路径）加到系统环境变量里 - macOS/Linux 用户如果用
tar.gz解压到/usr/local/go，需在 shell 配置文件（如~/.zshrc或~/.bash_profile）中追加：export PATH=$PATH:/usr/local/go/bin，然后执行source ~/.zshrc - 别信“重启终端就生效”——某些终端（比如 VS Code 内置终端）启动时不会重新加载 shell 配置，得彻底关掉再重开，或者直接在当前终端运行
source命令
go mod init 失败：no module found 和 missing go.sum
这说明 Go 已能运行，但模块初始化出了问题，通常发生在 GOPROXY 或网络受限环境下。
-
go mod init本身不联网，但后续首次go run或go build会尝试拉取依赖，若国内直连proxy.golang.org失败，就会卡住甚至报错no module found - 推荐立即设置代理：
go env -w GOPROXY=https://goproxy.cn,direct（国内稳定）或https://proxy.golang.org（海外） - 如果项目已有
go.mod但缺go.sum，不是删了重来，而是运行go mod download让它补全校验和 - 注意：Go 1.16+ 默认启用模块模式，不再依赖
GOPATH；但如果你看到cannot find module providing package，大概率是当前目录不在模块根下，先确认go.mod文件是否存在
VS Code 里 go test 灰掉或提示 “Go extension not activated”
不是插件没装，而是 Go 扩展不知道 go 在哪——它依赖 PATH 查找可执行文件，跟终端是否能跑 go version 是同一套逻辑。
- VS Code 启动方式很重要：必须从命令行用
code .打开项目，而不是双击图标。否则它继承的是图形界面的环境变量，不是你 shell 里配好的 PATH - 检查 VS Code 设置里的
go.gopath和go.goroot，新版扩展已不推荐手动填；优先留空，让它自动探测 - 如果仍不识别，打开命令面板（
Ctrl+Shift+P），执行Go: Install/Update Tools，勾选全部，让扩展自己装一遍dlv、gopls等工具
go run main.go 报错：package main is not a main package
表面看是语法问题，实际多因工作目录或文件名不对。
- 确保当前目录下有且仅有一个
main.go，且文件开头是package main，函数是func main() - 不要把
main.go放在cmd/xxx/这类子目录里却在父目录执行go run main.go——Go 会按目录结构解析包，go run要求目标文件必须在当前目录 - 更稳妥的做法是用
go run .（注意点号），它会自动找当前目录下的main包，避免手误指定错文件 - 如果项目结构复杂（比如含多个
main包），用go run ./cmd/xxx显式指定路径，比go run xxx/main.go更可靠
go version、go env、which go（Linux/macOS）或 where go（Windows）这些命令比任何教程都直接。最容易被忽略的，其实是终端启动方式和环境变量加载时机——它们不声不响，却决定你能不能真正开始写代码。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
