go mod edit 不更新 go.mod 是因默认不写入，需加 -write 参数；import 路径基于模块名而非文件路径；replace 全局生效且发布前须删除；go test 失败常因 replace 未生效或工作目录切换。
go mod edit 添加本地包路径时，为什么 go.mod 里没更新？
因为 go mod edit 默认只修改文件，不自动写入；它像一个“只读编辑器”，必须加 -write 才真正落盘。不加这参数，改了也白改，go build 仍报 no required module provides package。
实操建议：
- 用
go mod edit -replace=github.com/your/repo=./local/pkg -write，路径必须是相对于当前go.mod所在目录的相对路径 - 如果本地包本身有
go.mod（比如是独立模块），替换时要确保它的module名和replace左侧完全一致，大小写都不能错 - 执行后立刻运行
go mod tidy，否则缓存可能让旧依赖残留，导致构建失败
用 import 导入本地包时，路径到底怎么写？
Go 不支持类似 Python 的相对导入（如 from . import xxx），所有 import 路径都基于模块名，不是文件系统路径。你写的 import "myapp/utils"，Go 会去 go.mod 里找 module myapp 下的 utils 子目录 —— 和你当前文件在哪、./utils 是否存在无关。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
-
import "./utils"→ 编译报错：invalid import path: "./utils" -
import "utils"→ 报错：cannot find module providing package utils，因为没在go.mod中声明该模块名 - 本地包目录叫
pkg/utils，但go.mod里module是myapp，那必须import "myapp/pkg/utils"，不能省略myapp/
go mod replace 和直接 go mod edit -replace 有啥区别？
没本质区别：后者就是前者的命令行封装。但容易踩的坑在于「作用域」和「顺序」。
实操要点：
-
replace是全局生效的，会影响所有依赖这个模块的地方，不只是你当前项目 —— 如果多人协作，别把replace提交到主分支 - 多个
replace冲突时，后写的会覆盖先写的；可以用go mod edit -json看当前完整规则 - 开发阶段用
replace没问题，但发布前务必删掉，否则别人go get会失败 —— 因为他们的机器上没有你的./local/pkg路径
为什么 go build 成功了，但 go test 却找不到本地包？
因为 go test 在某些情况下会临时切换工作目录（尤其是测试位于子模块或使用 -exec 时），导致相对路径失效；更关键的是，go test 会重新解析模块依赖，如果 replace 规则没被正确加载，就会回退到远程路径。
排查和解决：
- 运行
go test -v -x，看实际执行的go list命令是否包含你期望的本地路径 - 确认测试文件所在目录有
go.mod，且该文件中已通过replace显式声明了本地包映射 - 避免在
test目录下单独运行go mod tidy，它可能生成错误的go.sum条目，干扰主模块解析
本地包路径不是文件路径，而是模块路径 + 目录结构的组合；最常被忽略的，是忘记检查 go.mod 里的 module 名是否和 import 语句开头完全一致。