Go分布式爬虫启动失败主因是环境配置问题：PATH未包含/usr/local/go/bin、GO111MODULE未启用、GOPROXY未设国内镜像（如goproxy.cn）、GOSUMDB未临时关闭，导致go命令不可用、模块无法下载。
Go 分布式爬虫跑不起来，八成卡在环境这一步——不是代码写得不对，是 go 命令根本没认出来，或者 GO111MODULE 关着，go get 一堆超时或 403。
确认 go 命令是否真可用
别只看终端里敲了 go version 就以为完事。很多开发者装完直接 source ~/.bashrc，但 shell 没 reload，PATH 里压根没加 /usr/local/go/bin。
- 执行
which go，输出为空？说明 PATH 没生效，重开终端或手动运行source ~/.bashrc - 执行
go env GOPATH，返回空值？说明 GOPATH 没设（Go 1.16+ 默认使用模块模式，但某些老项目或 IDE 仍依赖 GOPATH） -
go version显示版本低于 1.19？分布式爬虫常用net/http的http.Client超时控制、context取消等特性，建议至少用 1.20+
必须打开 Go Module 并配好代理
不用 go mod，所有第三方库（比如 github.com/gocolly/colly 或 github.com/rod/rod）都会下载失败——国内直连 proxy.golang.org 几乎必超时。
- 执行
go env -w GO111MODULE=on，强制启用模块模式（Go 1.16+ 默认开启，但某些旧安装可能关着） - 执行
go env -w GOPROXY=https://goproxy.cn,direct，用国内镜像源；若公司内网限制，可换为https://mirrors.aliyun.com/goproxy/ - 执行
go env -w GOSUMDB=off（仅开发阶段），避免校验失败中断依赖拉取；上线前应恢复默认
验证依赖能否正常拉取
别急着写爬虫逻辑，先用最小闭环测通整个链路：
立即学习“go语言免费学习笔记（深入）”；
mkdir myspider && cd myspider go mod init myspider go get github.com/PuerkitoBio/goquery@v1.10.0
如果卡在 go: downloading... 超过 30 秒，或报错 failed to fetch / 403 Forbidden，基本就是代理或网络策略问题。
- 检查是否漏设
GOPROXY：运行go env GOPROXY确认输出非空且含有效地址 - 若用企业网络，确认防火墙未拦截
goproxy.cn域名或其 IP - 临时绕过代理测试：加
-u参数并指定 commit（如go get github.com/PuerkitoBio/goquery@5a7d852），看是否单纯是 tag 解析失败
真正麻烦的不是装 Go，而是环境变量在不同 shell（zsh/bash）、不同终端窗口、IDE 内置终端之间不一致。每次新开终端或启动 VS Code，都得重新确认 go env 输出是否和你预期一致——这点最容易被忽略，也最难 debug。
