go命令未找到或go version异常，说明go二进制未加入path或终端未重启：windows需重启powershell/cmd，macos/linux须将/usr/local/go/bin（或arm64的/opt/homebrew/bin）显式添加至shell配置并source。
go version 输出异常或命令未找到
说明 Go 二进制没进 PATH，或者安装后没重启终端。Windows 上 .msi 安装器虽自动写入环境变量，但旧终端进程不继承新变量；macOS/Linux 用 brew install go 或手动解压方式安装时，PATH 必须显式添加 /usr/local/go/bin（macOS ARM64 可能是 /opt/homebrew/bin），且要确认 shell 配置文件（~/.zshrc 或 ~/.bash_profile）已执行 source。
常见错误现象：
command not found: go-
go: command not found（PowerShell 中可能显示为“无法识别的 cmdlet”）
实操建议：
- 运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows CMD）确认路径是否含 Go 的 bin 目录 - Windows 用户若用 PowerShell，检查是否在管理员权限下安装，或尝试重启 PowerShell 再执行
go version - macOS 用户若用 M1/M2 芯片，避免混用 Intel 和 ARM64 版本的 Go 安装包，
uname -m输出arm64就该下darwin-arm64包
go mod init 失败：module path 不能以点号或大写字母开头
说明 go mod init 后跟的模块名不是合法的导入路径。Go 模块路径必须是可解析的域名格式（如 example.com/myproj），不能是本地相对路径（如 ./myproj）或含非法字符（空格、下划线、大写字母开头）。
常见错误现象：
go: cannot determine module path for source directorygo: malformed module path "MyProject": leading capital letter
实操建议：
- 直接用小写字母+连字符+域名风格命名，例如
go mod init github.com/yourname/hello或go mod init example.com/api - 避免用当前目录名直接当模块名，尤其当目录名含空格或中文时——先重命名目录再 init
- 如果只是临时测试，用
go mod init temp也能通过，但后续导入其他包时会因路径不匹配报错，不推荐长期使用
VS Code 中调试器启动失败，提示 dlv 未安装或找不到
说明 VS Code 的 Go 扩展依赖 dlv（Delve）作为底层调试器，但该工具未安装，或安装后不在 PATH 中。
实操建议：
- 手动安装：运行
go install github.com/go-delve/delve/cmd/dlv@latest（注意末尾的@latest不可省略） - 安装后检查是否生效：
which dlv（macOS/Linux）或where dlv（Windows CMD）应返回路径，如$HOME/go/bin/dlv - 若
which dlv无输出，确认$HOME/go/bin已加入PATH，且 VS Code 是从终端启动（code .），否则 GUI 启动的 VS Code 可能读不到 shell 的环境变量 - VS Code 设置里禁用 “Auto Install Tools”，改用手动安装，避免扩展在后台静默失败却无提示
go run hello.go 报错：no required module provides package
说明项目根目录下没有 go.mod 文件，或当前工作目录不是模块根目录。Go 1.16+ 默认启用 module-aware 模式，go run 要求代码在有效模块内，否则拒绝执行。
实操建议：
- 确保在模块根目录（即含
go.mod的目录）下执行go run，而不是子目录 - 如果刚新建文件，先运行
go mod init example.com/foo创建模块，再go run hello.go - 临时绕过模块检查（仅限单文件快速验证）：用
go run -mod=mod hello.go，但该参数不解决根本问题，仅作调试用 - 注意
go run不接受相对路径如go run ./main.go，除非当前目录是模块根目录且main.go在当前目录下
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
