go 1.25起支持go-import meta标签第四字段，可声明子目录映射以保持简洁导入路径并识别仓库级git标签；此前子目录放go.mod会导致路径变长且tag失效。
go.mod放在子目录时，导入路径变长且无法用仓库级tag
Go 1.25之前，把go.mod放到./pkg/core这种子目录下，会导致模块路径变成example.com/repo/pkg/core，而不是你想要的example.com/core。更麻烦的是，git tag v1.2.0默认只对根目录生效，子目录模块根本识别不到这个tag。
Go 1.25起支持go-import meta标签第四字段，可在HTML中声明子目录映射：
<meta name="go-import" content="example.com/core git https://github.com/user/repo example.com/core">
注意：第四字段必须是模块实际路径（如pkg/core），且Git仓库需在根目录保留该路径的go.mod——工具链才能正确解析@v1.2.0并定位到子目录。
容易踩的坑：
- 忘记在GitHub Pages或静态托管服务上部署含
go-import标签的example.com/core页面 - 第四字段写错成相对路径（如
./pkg/core）或绝对URL（必须是仓库内路径） - 本地开发时用
replace绕过，但CI环境没同步replace规则，导致构建失败
replace指令在CI和多人协作中失效
replace只作用于当前模块的go.mod，不会传递给下游依赖。A模块用replace github.com/x/log => ./internal/log，B模块依赖A，但B仍会从远端拉取github.com/x/log，除非B也显式replace。
真正可靠的本地依赖方案是：
- 所有模块统一使用语义化版本（如
v0.1.0），通过go mod edit -require和go mod tidy同步 - CI中用
git submodule或git subtree将内部模块作为子树检出，避免replace污染 - 若必须用
replace，在Makefile里统一注入：GOFLAGS="-mod=readonly" go build -mod=mod，防止tidy自动删掉replace
关键点：CI镜像里go env GOPROXY不能设为direct，否则会跳过本地replace直接连远端。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
多模块间循环引用被go tool静默忽略
Go不报错，但go list -m all会显示find: no matching modules，或go build时提示import cycle not allowed——这通常是因为两个模块互相import对方的包，而非模块路径本身循环。
检查方法：
- 运行
go list -f '{{.Deps}}' ./module-a | grep module-b，确认是否真有跨模块import - 用
go mod graph | grep module-a | grep module-b看依赖图是否成环 - 禁止模块间直接import；改用接口抽象+依赖注入，把具体实现下沉到
internal/或独立pkg/模块
一个常见误判：模块A import B，B import A的测试文件（xxx_test.go）。Go允许test-only import，但CI跑go build ./...会失败——因为go build默认不包含_test文件。
go get -u=patch在monorepo里反而加剧版本漂移
单模块项目里go get -u=patch很安全，但在monorepo里，多个模块共用同一组基础库（如github.com/org/log），每个模块各自执行-u=patch，会导致各模块锁定不同补丁版本（v1.2.3 vs v1.2.4），最终go mod tidy在根目录合并时冲突。
推荐做法：
- 根目录放一个
go.mod作为“依赖中枢”，所有子模块都通过replace指向它（仅限开发） - 发布前统一执行
go mod edit -dropreplace github.com/org/log，再go mod tidy -compat=1.21强制收敛版本 - 用
gofumpt -w和go mod verify做CI卡点，拒绝未收敛的go.sum
最易被忽略的细节：Go 1.23+ 默认启用GOSUMDB=off时，go mod download可能缓存旧哈希，导致verify失败——务必在CI里显式设GOSUMDB=sum.golang.org。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
