go version无响应需先检查PATH配置：Windows查$env:PATH，macOS/Linux用echo $PATH | grep go并source配置文件；gorun报错因缺少合法package main文件，需确认文件名、编码（UTF-8无BOM）及语法；go mod init提示非错误，仅表示未初始化模块；go test失败多因测试文件与源文件不在同目录或包名不一致。
go version 命令没反应？先确认 PATH 是否生效
安装完 Go 后，go version 报 command not found 或直接无输出，大概率是 PATH 没配对。Windows 的 .msi 安装器默认会加 C:\Program Files\Go\bin 到系统 PATH，但某些安全策略或用户权限下可能失败；macOS 的 .pkg 通常写入 /usr/local/go/bin，但 shell（尤其是 zsh）可能没读取 /etc/paths；Linux 手动解压后必须自己加 /usr/local/go/bin 到 ~/.bashrc 或 ~/.zshrc。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Windows：打开新 PowerShell，运行
$env:PATH -split ';' | Select-String 'Go'，看是否有匹配路径 - macOS/Linux：执行
echo $PATH | grep go，没输出就补一行export PATH=$PATH:/usr/local/go/bin（注意路径是否真为/usr/local/go），然后source ~/.zshrc（或~/.bashrc） - 别用
sudo su后再试——root 用户的 PATH 和当前用户不同，容易误判
gorun hello.go 报错“no Go files in current directory”
这个错误不是因为文件名不对，而是当前目录里没有合法的 package main 入口文件，或者文件扩展名不是 .go。常见陷阱包括：文件实际叫 hello.go.txt（Windows 默认隐藏扩展名）、用了中文标点、保存编码是 UTF-8 with BOM（Go 不认）、或者文件里写了 package utils 却没 main 函数。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
ls -la（macOS/Linux）或dir（Windows）确认文件名确实是hello.go，不是hello.go.txt - 用
file hello.go（macOS/Linux）或chcp+ 记事本另存为 UTF-8（无 BOM）检查编码 - 内容必须严格包含：
package main、import "fmt"、func main() { ... }——少一行或大小写错（比如Func Main()）都会失败 - 不要在
$GOPATH/src下随便建文件夹再跑 —— Go Modules 模式下不需要 GOPATH，直接在任意空目录操作更干净
go mod init 报错“working directory is not part of a module”
这是 Go 1.11+ 默认启用 Modules 后的正常提示，不是错误。它只说明当前目录还没初始化模块，go run 仍能跑单文件，但一旦涉及 import 第三方包（比如 github.com/gorilla/mux），就必须有 go.mod 文件。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 想快速开始：在项目根目录执行
go mod init example.com/hello（模块名可以是任意合法域名或假名，不一定要真实存在） - 模块名影响后续
go get行为，如果将来要发布到公共仓库，建议用真实域名或 GitHub 用户名，比如github.com/yourname/hello - 如果只是临时测试，不 import 外部包，跳过
go mod init也完全没问题 —— Go 会以“module-aware mode”运行，但不会生成go.mod - 别手动创建空
go.mod文件 ——go mod init会自动写入 Go 版本声明，手动写错格式会导致后续go build失败
go test 运行失败，提示“cannot find package”
这通常发生在测试文件（*_test.go）和被测代码不在同一目录，或包名不一致。Go 要求测试文件和源文件必须在同一个 package 下，且不能跨目录 import 自己的非导出函数（小写字母开头）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保
hello.go和hello_test.go在同一目录，且都声明package main - 测试函数名必须是
TestXxx（首字母大写），参数必须是*testing.T，例如func TestHello(t *testing.T) - 如果被测函数是
func greet() string（小写），测试文件里无法直接调用 —— 要改成func Greet() string才能导出 - 运行测试时别加文件名：用
go test，而不是go test hello_test.go—— 后者会忽略hello.go，导致“undefined: greet”
真正卡住的地方往往不是语法，而是路径、编码、shell 配置这些“看不见”的环节。每次失败，先 pwd 看目录、ls 看文件、cat hello.go | head -n 5 看开头几行 —— 比查文档更快定位问题。
