GoLand中移出代码前必须先用replace隔离路径，即在主go.mod添加replace映射并确保新路径有合法go.mod，否则编译报错；再手动替换所有import引用、抽离接口与DTO、验证无循环依赖，三步缺一不可。
GoLand 里移出代码前必须先用 replace 隔离路径
直接剪切粘贴文件会立刻炸——编译报 cannot find module providing package，因为老模块的 import 路径（比如 github.com/yourorg/project/user）还硬编码在各处，而你刚把代码挪到 ./internal/user 下，Go 模块系统根本找不到对应包。
正确做法是先在主模块的 go.mod 里加一行：replace github.com/yourorg/project/user => ./internal/user，再跑 go mod tidy。这步不是“临时 workaround”，而是让新旧路径并存运行的强制隔离层。
- 路径必须相对于当前模块根目录，不能写
./local/user或../user，否则replace静默失效 -
./internal/user目录下必须有合法go.mod（哪怕只有一行module github.com/yourorg/project/internal/user），否则 Go 忽略该replace - 如果
go mod tidy报require internal/user: version is required，说明replace没生效或路径拼错，不是版本问题
移动后要立刻删掉老路径下的 import 引用
GoLand 的 “Move” 重构（F6）对跨模块移动无效——它只改文件位置和包名，不碰其他文件里的 import 语句。老代码里仍写着 import "github.com/yourorg/project/user"，而你已把实现挪走，编译必挂。
必须手动或批量替换所有引用：
- 全局搜索
import "github.com/yourorg/project/user"，替换成新包的 contract 接口路径（如import "github.com/yourorg/project/usercontract"） - 绝不能替换成
import "./internal/user"或import "github.com/yourorg/project/internal/user"——internal/是私有边界，外部模块不该 import 它 - 如果老代码里直接用了
user.User这类 struct，得先抽成接口 + DTO，再让新包实现，否则类型不兼容
检查循环依赖比编译报错更早暴露问题
移出代码后看似能编译，但运行时 panic 或测试失败，大概率是循环依赖没断干净。GoLand 不会自动检测这个，得靠命令行验证。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
在终端执行：go list -f '{{.Deps}}' ./internal/user | grep project，如果输出里同时出现 project/user 和 project/order，说明两个包互相 import，接口没抽干净。
- 循环依赖常源于“数据结构共享”——比如两边都定义了
type Order struct{}并互相传参，必须统一收口到contract.go - 别依赖 IDE 的 “Find Usages”，它查不到跨模块的 import 关系，
go list才是真实依赖图 - 一旦发现循环，退回上一步：先把共用字段提成独立 DTO 包，再让两边都 import 它，而不是彼此引用
go mod vendor 会清空旧 patch，必须提前用 replace 锁定
如果你老项目 vendor 里打过自定义 patch（比如改过某依赖的 bug），直接 go mod vendor 会覆盖掉——新生成的 vendor 只含 go.sum 锁定的原始版本，patch 全丢。
要保留 patch，必须在 go.mod 里用 replace 显式指向本地修改版：
- 把 patch 后的依赖 clone 到本地，比如
~/go-patches/zerolog - 在主
go.mod加：replace github.com/rs/zerolog => ../go-patches/zerolog - 再跑
go mod vendor，它才会把本地目录内容复制进 vendor - 注意：被
replace的目录下必须有go.mod，且模块名与原依赖一致，否则go mod vendor忽略
真正麻烦的不是移动动作本身，而是路径映射、接口抽象、依赖切割这三步缺一不可——少走任何一环，都会在 CI 构建或线上运行时突然崩掉。
