goland需显式配置才能正确识别internal包边界：必须确保项目有有效go.mod、internal子目录不单独声明module，并禁用自动导入以防跨边界补全，否则会掩盖设计缺陷。
GoLand 本身不决定重构成败，但能显著降低出错概率——关键在于它能否准确识别 internal 边界、跨模块依赖和接口实现链。盲目用「Move Class」或「Extract Method」会破坏 domain 自包含性，导致 user/service.go 意外引用 order/repository。
如何让 GoLand 正确识别 internal 包边界
GoLand 默认按目录结构解析包可见性，但 internal 的语义限制需显式配置才能生效。否则它可能允许 cmd/api 直接 import internal/domain/user/internal/db，而编译器后期才报错。
- 在
Settings → Go → Build Tags中添加ignore或自定义 tag（如dev），避免误加载测试/内部工具包 - 确保项目根目录下有有效的
go.mod，且每个internal/domain/*子目录不单独声明 module；否则 GoLand 会将其视为独立模块，绕过internal规则 - 禁用
Settings → Editor → General → Auto Import → Add unambiguous imports on the fly：它常自动补全跨internal边界的导入路径，掩盖设计缺陷
安全重命名接口方法时的三个前提
直接右键 UserCreator.Create → «Refactor → Rename» 看似方便，但若该接口被多个模块实现（如 HTTP handler、worker、mock），GoLand 可能漏改某处，或把 user.Interface 里定义的 Create 改成 CreateUser，却没同步更新 user/service.go 中的实现签名，导致编译失败。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先确认该方法是否只被本 domain 模块使用：在
user/interface.go中右键方法名 → «Find Usages»，过滤掉test和mock后，应仅显示user/service.go和user/handler.go - 检查所有实现是否满足小接口原则：若
userSvc结构体嵌入了UserService这种巨接口，Rename 会波及无关方法；应先拆解为type userSvc struct{ creator UserCreator }再操作 - 启用
Settings → Editor → General → Refactorings → Rename → Search in comments and strings：DTO 的Validate()方法名常被硬编码在错误信息里（如"missing email in CreateUserRequest"），必须一并更新
重构 DTO 时避免 Gin handler 校验逻辑残留
把 c.ShouldBindJSON(&req) 后的 if req.Email == "" 移到 api/v1/user_create_request.go 的 Validate() 方法里，是正确方向。但 GoLand 的 «Extract Method» 容易出问题：它可能把 strings.TrimSpace(req.Email) 也抽成新函数，而该逻辑实际属于数据转换（应放 service 层），不是校验。
- 手动创建
api/v1/user_create_request.go，定义结构体并实现Validate() error，只做空值、格式、长度检查，不调用strings或time - 在 handler 中删掉所有
if判断，只保留if err := req.Validate(); err != nil { c.Error(err); return } - 用 «Find Usages» 检查旧校验逻辑是否残留：搜索
req.Email == ""或!isValidEmail，确保结果为空
最易被忽略的是 replace 指令与 GoLand 缓存的冲突：当你在 user-service/go.mod 里用 replace example.com/project/user => ./internal/domain/user，GoLand 可能仍缓存旧的 module 路径，导致「Go to Implementation」跳转失败。此时需手动触发 File → Reload project from disk，而非依赖自动同步。
