replace路径必须是相对路径，如../utils；不能用~或绝对路径；需确保被替换目录含有效go.mod；GoLand需手动配置GOPROXY/GOSUMDB；replace仅对当前模块生效，不传递给下游。
replace 路径必须是相对路径，不能用 ~ 或绝对路径
Go 的 replace 指令只接受相对于当前 go.mod 文件的路径。比如你的主模块在 ./service，想把 github.com/yourname/utils 替换成本地开发中的 ../utils，就必须写成：
replace github.com/yourname/utils => ../utils
常见错误包括：
- 写成
~/projects/utils或/home/user/projects/utils—— Go 会直接报错malformed module path - 路径指向不存在的目录 ——
go mod tidy会失败，且 GoLand 编辑器里 import 仍标红 -
../utils目录下没有有效的go.mod（哪怕只有一行module github.com/yourname/utils）—— Go 会 fallback 到 legacy GOPATH 模式，导致依赖解析混乱、go list -m all不显示该替换
GoLand 不自动继承 GOPROXY/GOSUMDB，必须手动填进 Settings
你在终端里执行 go env GOPROXY 看到值是 https://goproxy.cn,direct，不代表 GoLand 就用了它。GoLand 启动自己的 go 进程调用 go list -mod=readonly 来解析依赖，它默认不读系统环境变量。
必须手动配置：
- 打开 Settings → Go → Go Modules
- 勾选 Enable Go Modules integration
- 在 Environment 输入框中填入：
GOPROXY=https://goproxy.cn,direct（不要留空，也不要只写direct） - 同样建议填上：
GOSUMDB=gosum.io+ce6e75650+AY5qEHUk/qmHc5btzW45JVoENfazw8LielDsaI+lEbq6
否则即使 replace 写对了，GoLand 仍可能因无法校验上游模块而拒绝索引本地替换路径，表现为：代码补全失效、跳转不到 ../utils 里的函数、go mod tidy 在 Terminal 成功但编辑器里依然标红。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
replace 只作用于当前模块，下游看不到也不生效
replace 是构建时的“本地覆盖”，不是发布语义。它不会出现在 go list -m all 的输出里，也不会被 go mod vendor 收录，更不会传递给依赖你这个模块的其他项目。
这意味着：
- 如果你的
service模块通过replace引用了本地../utils，然后别人go get ./service，他们拿到的仍是原始github.com/yourname/utils版本 -
go mod graph不会显示../utils节点，只显示被替换前的原始模块名 - CI 构建时若没同步
../utils目录或没设好工作路径，replace会直接失效，构建失败
调试时 replace 生效但断点不命中？检查 dlv 和模块路径一致性
Delve（dlv）调试器启动时会按模块路径加载源码。如果 replace 指向的 ../utils 路径和 dlv 实际读取的路径不一致（比如 GoLand 启动调试时工作目录不是 ./service），断点就会灰掉或跳转失败。
确保：
- Run Configuration 中 Working directory 设为
$ProjectFileDir$（即service根目录） -
Package path 填
./，不是main.go文件路径 - Delve 设置选 Use built-in delve（Settings → Go → Debugger → Delve），避免旧版 dlv 对
replace路径解析有 bug
最易忽略的一点：../utils 里的代码修改后，必须手动触发 go mod tidy 或重启 GoLand 的 module indexer，否则调试器仍加载旧缓存。
