go 1.21+起go指令变为强制性要求，不同go版本下go mod tidy生成的go.mod可能含高版本特有约束（如+incompatible写法），导致低版本构建失败；必须统一锁死.go-version并配置goprivate，replace未清理或路径错误会引发ci静默失败，go.sum须随go.mod一同提交以确保依赖锁定。
go mod tidy 在不同 Go 版本下行为不一致会直接导致协同构建失败
Go 1.21 和 Go 1.22 对 io.ReadAll、net/http 默认行为等有实质性差异，而 go mod tidy 在不同 Go 版本下执行 MVS 算法时，对 +incompatible 版本的兼容性判断也不同。团队中只要有人用 1.22 运行 go mod tidy，生成的 go.mod 就可能包含 1.22 才支持的约束写法（如 require github.com/x/y v2.0.0+incompatible），另一台装着 1.21 的机器执行 go build 时就会报错。
必须统一锁死 .go-version 文件，并确保 CI 和本地开发环境都严格读取它——actions/setup-go@v5 支持自动解析该文件，goenv 和 asdf 也依赖它切换版本。别把 Go 版本硬编码进 Makefile 或 shell 脚本，那是不可靠的副本。
replace 指令未清理就提交会导致 CI 构建静默失败
replace 是调试利器，但也是协同陷阱。常见错误包括：
- 用
replace github.com/some/lib => ./local-fix本地验证后，忘记删掉这行就提交 PR，CI 因找不到./local-fix路径直接go mod download失败 - 用
replace github.com/some/lib => github.com/your-fork/lib v1.5.0-fix后没同步上游关键安全补丁，别人拉代码时 unknowingly 使用了有漏洞的 fork - 替换到
v2.0.0+incompatible版本，但没改 import path（仍为github.com/some/lib而非github.com/some/lib/v2），导致类型不匹配错误只在某些模块里出现，难以复现
所有 replace 行都应加注释说明用途和预期移除时间，CI 流水线可加检查：禁止 go.mod 中存在 => ./ 或 => ../ 的路径。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
go list -m all 显示多版本 ≠ 实际冲突，但会掩盖真实问题
多人协作时，go list -m all 经常显示同一模块多个版本（比如 github.com/sirupsen/logrus v1.9.0 和 v1.14.0），但这只是 MVS 选中的最终版本和被排除的间接版本共存痕迹，不等于编译失败。真正危险的是：
- 某个子模块（如
./cmd/admin）显式require了v1.14.0，而主模块仍requirev1.9.0，结果go mod graph | grep logrus显示两条路径，且go mod why github.com/sirupsen/logrus@v1.14.0返回“main module requires it”，说明它已被提升为主依赖 -
go.sum里同一模块有多个校验和，且对应不同 commit hash，说明构建过程曾拉过多个版本——这本身没问题，但如果某次go mod tidy后没提交更新后的go.sum，别人go build时可能因校验失败中断
协同开发中，go.sum 必须随 go.mod 一起提交，且每次 go mod tidy 后都要确认 diff 是否合理。忽略它，等于放弃依赖锁定。
私有模块未配置 GOPRIVATE 会让不同开发者看到完全不同的依赖树
企业项目常引入内部私有库，比如 git.internal.company.com/go/utils。若没在 GOPRIVATE=git.internal.company.com/* 环境变量中声明，Go 默认走 proxy.golang.org，结果是：
- 开发者 A 本地配置了
GOPRIVATE，能正常拉取私有库并构建成功 - 开发者 B 没配，
go get时 fallback 到 proxy，返回 404 或空响应，go mod tidy自动降级或跳过该依赖，导致编译缺失符号 - CI 环境通常默认不设
GOPRIVATE，除非显式在 workflow 中配置env: GOPRIVATE: git.internal.company.com/*
最稳妥做法：在项目根目录放一个 .goprivate 文件（内容即 git.internal.company.com/*），CI 和本地脚本统一读取它来设置环境变量；同时要求所有成员在 shell 配置中导出 GOPRIVATE，避免依赖个人习惯。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
