Go开发环境搭稳需满足三要素：go命令可用、go mod能锁依赖、GOOS/GOARCH可交叉编译；若go version报command not found，实为PATH未生效，须手动确认Go二进制路径（如/usr/local/go/bin或C:\Go\bin）已加入系统PATH并重启终端验证。

go 命令能跑起来，go mod 能锁依赖，GOOS/GOARCH 能交叉编译出目标平台可执行文件——这三件事做对了，Golang 开发环境就算搭稳了。其余都是锦上添花。

go version 报 command not found 怎么办

不是没装好，是 PATH 没生效。别信安装器勾选的“添加到 PATH”，它常失效。

• macOS/Linux：运行 which go，没输出就检查 /usr/local/go/bin（或你解压的路径）是否加进 ~/.zshrc 或 ~/.bash_profile；改完记得 source ~/.zshrc
• Windows：用 PowerShell 运行 Get-Command go；失败就去「系统属性 → 高级 → 环境变量」里确认 C:\Go\bin（或你安装路径）进了 PATH
• 验证：新开终端，直接输 go version，有输出才算真通

go mod init 失败或生成错误 module 名

旧项目残留干扰最常见，go mod init 不是万能钥匙，它会看上下文猜你想干啥。

• 删掉项目根目录下的 vendor/ 目录（除非你明确要用 vendor）
• 确保当前目录不在 $GOPATH/src 下——如果在，go mod init 会强行按旧路径推导 module 名，比如变成 src/myapp，这不是你想要的
• 运行 go env -w GO111MODULE=on 强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着）
• module 名写成 hello、mytool 都行，不强制要域名；后续发布时再改成 github.com/user/repo

在 macOS 上构建 Windows 可执行文件失败

不是 GOOS=windows 就万事大吉，cgo 和 CGO_ENABLED 是隐形开关。

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

• 默认 CGO_ENABLED=1，一旦代码里用了 import "C"（比如调 SQLite、OpenSSL），构建就会卡住，报错类似：exec: "gcc": executable file not found in $PATH
• 纯 Go 项目（没 cgo）：直接 GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go 即可
• 含 cgo 的项目：要么装 MinGW-w64（macOS 上麻烦），要么用 Docker 构建——推荐 docker run --rm -v $(pwd):/app -w /app golang:1.22 bash -c 'CGO_ENABLED=1 GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go'
• 想彻底规避 cgo？加 CGO_ENABLED=0，但注意：部分标准库（如 net DNS 解析）行为会降级，且无法链接 C 库

多人共用服务器时 GOPATH 冲突

go install 写入 $GOPATH/bin，go mod download 写入 $GOCACHE，NFS 挂载家目录下并发写容易损坏缓存。

立即学习“go语言免费学习笔记（深入）”；

• 每个用户在家目录独立解压 Go：比如 ~/local/go，然后 export GOROOT=$HOME/local/go、export PATH=$GOROOT/bin:$PATH
• 显式设 GOPATH=$HOME/go、GOBIN=$HOME/bin、GOCACHE=$HOME/.cache/go-build（避免 NFS 锁争用）
• 禁用 go env -w：它写入的 $HOME/go/env 是纯文本，无权限校验，误用 sudo go env -w 会污染所有用户环境

跨平台构建真正难的不是命令怎么敲，而是判断哪段代码依赖了 cgo、哪台机器的 GOCACHE 已被并发写坏、哪个同事悄悄改了 GO111MODULE 环境变量——这些点不查日志、不看 go env 输出，光靠重装 Go 解决不了。