Go环境装好不等于能编译运行，核心是路径与模块初始化未对齐：需确认go命令真实可用（which go/where go）、GOROOT/GOPATH正确、GO111MODULE=on且项目不在GOPATH/src下；go mod init必须在空目录执行并指定合法模块名；go run要求当前目录有且仅有一个package main；国内需配置GOPROXY=https://goproxy.cn。
Go 语言环境搭好了不等于能编译运行，很多卡在 go run 报错或 GOROOT/GOBIN 混乱上——核心是路径和模块初始化没对齐。
确认 go 命令是否真可用，而不是“看起来有”
很多人执行 go version 成功就以为装好了，但实际 go run main.go 报 command not found: go 或 cannot find module providing package。这是因为：
- 终端新开的 shell 没重载
$PATH，尤其 macOS 使用 zsh 但安装脚本改了 bash_profile； - Windows 用户用 Git Bash 运行
go，但安装包只注入到 PowerShell/Command Prompt 的 PATH； -
go二进制存在，但权限被系统拦截（macOS Gatekeeper / Windows SmartScreen）。
实操建议：
- 在终端里直接运行
which go（macOS/Linux）或where go（Windows CMD），确认路径真实存在； - 执行
go env GOROOT和go env GOPATH，检查输出是否为预期路径（如/usr/local/go）； - 如果用 Homebrew 安装，别手动删
/usr/local/bin/go，应运行brew uninstall go再重装。
go mod init 必须在项目根目录执行，且不能嵌套在 GOPATH 下
Go 1.16+ 默认启用 module 模式，但新手常把代码放在 $GOPATH/src/xxx 里，再跑 go mod init，结果编译时提示 go: cannot find main module 或导入路径错乱。
立即学习“go语言免费学习笔记（深入）”；
原因：module 要求项目根目录有 go.mod，且该目录不能是 GOPATH/src 的子目录（否则会 fallback 到 GOPATH mode）。
实操建议：
- 新建空目录（如
~/myapp），cd 进去，再运行go mod init myapp； - 模块名不必和路径一致，但建议用小写字母+短横线，避免大写或下划线（
my-app✅，MyApp❌）； - 如果已有旧项目，先删掉
go.mod和go.sum，再重新go mod init，别试图“修复”损坏的 module 文件。
go run 和 go build 对 main 包的要求不同
写了个 main.go 却报 no Go files in current directory，或者 build failed: no main package，大概率是文件结构或 package 声明不对。
关键点：
-
go run只找当前目录下的*.go文件，不递归子目录； - 必须有且仅有一个
package main，且含func main()； - 如果有多个
.go文件，全部都要是package main，不能混package utils； -
go build默认生成可执行文件到当前目录，而go install才会放GOBIN，别误以为go build就是安装。
一个最小可运行示例：
mkdir hello && cd hello<br>echo 'package main<br>import "fmt"<br>func main() { fmt.Println("ok") }' > main.go<br>go mod init hello<br>go run main.go
Windows 上 go test 失败常见于换行符和 exec 权限模拟
Linux/macOS 下跑通的测试，在 Windows 上执行 go test -v 突然卡住或报 exec: "sh": executable file not found，尤其涉及 os/exec 或调用 shell 脚本时。
这不是 Go 本身问题，而是 Windows 子系统行为差异：
- Go 测试中若用
exec.Command("sh", "-c", "...")，Windows 默认没有sh，需改用cmd或加条件判断； - 文本文件换行符（CRLF vs LF）可能影响读取逻辑，比如解析配置时按
\nsplit 却遇到\r\n； - 某些第三方库（如
golang.org/x/sys/unix）在 Windows 下不可用，测试里直接 import 会导致构建失败。
实操建议：
- 用
// +build !windows注释标记平台敏感测试文件； - 替换 shell 调用为
exec.Command("cmd", "/c", "...")（注意参数格式差异）； - 读文件时统一用
strings.TrimSpace或strings.TrimRight处理行尾符，别硬切\n。
真正容易被忽略的是：Go 的 module proxy（GOPROXY）在国内默认不通，go get 卡住不是网络问题，而是没设 https://goproxy.cn 或 https://proxy.golang.org ——这一步漏掉，后面所有依赖操作都会反复失败。
