replace右侧写./xxx编译失败，因为go工具链硬性禁止以./开头的相对路径——它要求右侧必须是可识别的模块根目录（含匹配module声明的go.mod），且需跨环境稳定，如用../subdir或绝对路径；./xxx因依赖执行目录而失效。
replace 右侧写 ./xxx 为什么编译失败
因为 Go 工具链明确禁止在 replace 指令右侧使用以 ./ 开头的相对路径——它会直接报错 invalid replace directive，不是语法警告，而是硬性拒绝解析。
根本原因在于：Go 要求 replace 的右侧必须指向一个「可识别的模块根目录」，即该路径下必须存在合法的 go.mod 文件，且其 module 声明要与左侧完全一致。而 ./xxx 这种写法无法在跨环境（如 CI）中稳定解析，工作目录一变就失效。
- 错误示例：
replace example.com/lib => ./local-lib→ 立刻报错 - 正确做法是用相对于
go.mod所在目录的路径，比如replace example.com/lib => ../local-lib（前提是../local-lib是个含go.mod的 Git 仓库） - 若本地调试需要绝对路径，可用
replace example.com/lib => /home/user/local-lib，但不可提交到共享代码库
go.work 中 use ./subdir 导致跨模块 import 失败
当 go.work 里写 use ./cmd/api，但实际想让 ./pkg/storage 能导入 ./internal/utils 时，容易忽略一个硬约束：每个 use 目录必须自带完整、独立的 go.mod，且模块路径不能重叠。
常见翻车点是把 internal/ 目录单独 use 进来，或让两个 use 路径存在父子关系（如同时 use ./a 和 use ./a/b），这会导致 Go 工具链无法确定包归属，报错 ambiguous import 或 cannot load。
-
go.work不是“合并模块”，只是提供统一视图；模块边界依然由各子目录下的go.mod决定 - 运行
go list -m all -work可确认当前工作区是否真正加载了所有use的模块 - 如果某个子模块没被
use，又恰好在它的目录下执行go run .，Go 会退回到单模块模式，本地修改不生效
import "./pkg" 触发 inconsistent definition of package 错误
这是最典型的模块路径错配现象。Go 强制要求「导入路径 = 模块路径」，而 import "./pkg" 完全绕过了这一规则，导致 go build 在解析依赖时认为同一个包被定义了两次：一次来自模块路径（如 github.com/user/repo/pkg），一次来自文件系统相对路径（./pkg）。
结果就是编译器报 go: inconsistent definition of package xxx，或者更隐蔽的 cannot find module providing package ./pkg。
- 所有本地子包（
cmd/、pkg/、internal/）都必须用完整模块路径导入，例如import "github.com/user/repo/pkg/client" -
go mod tidy不会帮你修正导入路径，它只管require声明；路径替换需手动或借助gofmt -r等工具 - IDE（如 VS Code + gopls）跳转失效，往往就是这个原因：符号解析基于模块路径，不是文件位置
为什么 go list -m 显示正常，但 go build 仍找不到包
因为 go list -m 只反映模块声明状态，不验证导入路径是否真实可解析。你可能看到 github.com/user/repo 列出来了，但只要有一个 import "./internal/db" 存在，构建就会失败。
关键检查点不在模块是否存在，而在「当前工作目录是否在模块根下」以及「所有 import 语句是否严格匹配 go.mod 中的 module 前缀」。
- 运行
go list -m输出为空？说明当前路径不在任何模块根下，go.mod可能建错了位置 - 输出有值但构建失败？用
go list -f '{{.Dir}}' github.com/user/repo/internal/db看 Go 实际找的是哪个路径，再比对文件是否存在 - Windows 用户特别注意：路径中含空格或大小写混用（如
Github.comvsgithub.com）会导致校验失败，报checksum mismatch
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
