根本原因是path未包含go二进制目录；macos/linux需在~/.zshrc中添加export path=$path:/usr/local/go/bin并source，windows需在系统path新增c:\go\bin且重启终端，再运行go version验证。
Go安装后go version报错：command not found
根本原因不是没装Go，而是$PATH没包含/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows）。装完Go不等于命令行能直接用go。
- macOS/Linux：在
~/.zshrc或~/.bash_profile里加export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc - Windows：在系统环境变量
Path里新增C:\Go\bin，**必须重启终端**（CMD/PowerShell/VS Code终端都不认旧会话） - 验证方式不是双击安装包，而是新开一个终端运行
go version——如果还报错，说明PATH没生效，别往下走
为什么go mod init总提示cannot determine module path
这不是权限或网络问题，而是当前目录名含非法字符或不符合Go模块路径规范。Go要求模块路径是类似github.com/username/project的格式，但go mod init会尝试从目录名推导——如果目录叫my-project、123api、测试，就会失败。
- 解决方法：显式指定模块路径，比如
go mod init example.com/myproject（用任意合法域名前缀，不一定要真实存在） - 新手常误以为要先注册GitHub再初始化，其实不需要；
example.com只是占位符，后续发布时再改成真实地址 - 避免空格、中文、短横线开头、数字开头——这些都会触发
cannot determine module path
GO111MODULE=on到底要不要设？
Go 1.16+ 默认开启module模式，设这个环境变量已无必要，反而可能干扰行为。真正该关注的是GOBIN和GOPROXY。
-
GOBIN：控制go install生成的二进制文件放哪，默认是$GOPATH/bin，建议设为$HOME/go/bin并加入PATH，否则装的工具（如gofmt、delve）找不到 -
GOPROXY：国内必设，否则go get大概率超时。推荐https://goproxy.cn或https://proxy.golang.org（后者需科学上网），设法：go env -w GOPROXY=https://goproxy.cn,direct - 别设
GOROOT——除非你手动编译了Go源码，否则安装包已写死路径，乱设反而导致go命令失效
VS Code里go扩展报Missing required tool
不是插件坏了，而是它依赖的底层工具（如gopls、dlv）没装全。点提示里的“Install All”按钮经常失败，因为网络或权限问题。
- 手动装最稳：
go install golang.org/x/tools/gopls@latest（LSP服务）、go install github.com/go-delve/delve/cmd/dlv@latest（调试器） - 注意：Go 1.21+ 的
go install默认装到$GOBIN，确保$GOBIN在PATH里，否则VS Code还是找不到 - 如果装完仍报错，关掉VS Code重开——它只在启动时扫描一次
PATH下的工具
go、模块能否初始化、编辑器能否加载gopls，这三个动作必须逐个验证。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
