go version能运行但go run报错，说明go已安装成功，问题出在当前目录无合法main.go文件、未初始化模块（需go mod init）、或终端不在正确路径；需检查文件名、package main声明、go.mod存在性及执行目录。
Go 环境装好了，go version 能跑出来，但 go run main.go 报错“command not found”或“no Go files in current directory”，大概率不是 Go 没装好，而是路径、包结构或文件命名踩了坑。
go version 能运行，但 go run 报错找不到命令
这通常意味着 PATH 里确实有 go，但当前目录下没有合法的 Go 源文件，或文件不符合 Go 的包规则。
- 确认当前目录下存在且仅存在一个
.go文件（如main.go），且文件名不含空格、中文或特殊符号 -
package main必须是文件第一行，且不能有空行或 BOM 头（Windows 记事本易产生） - 文件不能放在系统临时目录、桌面或下载目录等权限受限路径——某些 macOS/Linux 环境会因 SIP 或沙盒限制拒绝执行
- 如果用 VS Code，检查终端是否在正确工作区目录下启动；别在资源管理器里双击打开终端，它可能默认进入用户根目录
main.go 写好了，go run 却提示 “cannot find package”
这不是缺包，而是 Go 当前版本（1.16+）默认启用 module 模式，而你没初始化模块，导致 import 被当作本地相对路径解析。
- 在项目根目录下运行
go mod init example.com/hello（域名随意，只是占位符） - 执行后会生成
go.mod文件，之后go run main.go才能正确定位fmt等标准库 - 若已存在
go.mod但报错，运行go mod tidy清理并补全依赖声明 - 注意：不要手动删
go.sum或改go.mod里的require行——除非你知道自己在同步哪个 commit
Windows 下 .msi 安装后 go 命令仍不可用
不是安装失败，而是 Windows 的环境变量更新延迟或作用域不对。
- 安装时勾选了 “Add Go to PATH” 选项？没勾的话，
C:\Go\bin不会自动加进系统Path - 安装完必须重启命令行（CMD/PowerShell/Terminal），旧窗口不会自动继承新环境变量
- 如果用了 Windows Terminal 或 Git Bash，它们可能读取的是用户级
Path，而非系统级——检查“环境变量”窗口里是改的“系统变量”还是“用户变量” - 验证方式：在新打开的 CMD 中运行
echo %PATH%，看输出里是否含C:\Go\bin
macOS 上 go install 后命令不生效
常见于 zsh 成为默认 shell 后，却还在修改 ~/.bash_profile。
- 运行
echo $SHELL确认当前 shell 类型（zsh 或 bash） - zsh 用户应编辑
~/.zshrc，而不是~/.bash_profile；写完记得source ~/.zshrc - 如果用 Homebrew 安装 Go（
brew install go），路径通常是/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），不是/usr/local/go/bin - 运行
which go查看实际路径，再按该路径配置PATH
真正卡住人的地方往往不是语法，而是 go.mod 是否存在、package main 是否顶格写、终端是否在对的目录——这些细节不报错，但会让 go run 静静失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
