goland提取函数要求选中代码语义完整：须为独立逻辑单元，不能跨函数、含裸return或破坏作用域；需统一变量、剔除副作用、手动补导入；合并前用find usages定位，统一签名后测试验证。
提取函数时选中代码必须语义完整
GoLand 的 Ctrl+Alt+M（Extract Function）不是“把几行复制粘贴过去就完事”的操作，它要求选中的代码块能独立构成一个逻辑单元：不能跨函数边界、不能含裸 return、不能破坏变量作用域。比如你有两处都做了 “校验用户权限 + 构造错误响应”，但一处在 if err != nil 分支里，另一处在 switch case 中 —— 直接选中会报错“Selected code cannot be extracted”。
- 先手动补全缺失变量：若某段代码依赖外部变量
userID，而另一处用的是u.ID，得先统一成参数形式 - 删掉干扰语句：比如其中一段末尾多了一句
log.Info(...)，它不属于核心逻辑，得先剪掉再选中 - 确认无副作用：如果代码里有
defer db.Close()或修改全局状态，这类不可迁移的逻辑必须剥离
重命名后要检查跨包引用是否生效
当你把两段相似逻辑合并成新函数 validateUserPermission 并提取到 pkg/auth 后，原调用处可能仍显示灰色（未识别），这是 gopls 没自动加导入导致的。GoLand 不会为提取出的新函数自动插入 import "yourproject/pkg/auth"，尤其当原文件和目标包不在同一模块或 vendor 模式开启时。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 手动加 import：光标停在新函数名上按
Alt+Enter→ 选 “Add import for 'validateUserPermission'” - 验证跨包可见性：确保该函数首字母大写，且
pkg/auth/auth.go文件顶部有package auth（不是package auth_test） - 如果调用方在
main包，而go.mod里没声明require yourproject v0.0.0，gopls会静默失败，此时需运行go mod tidy
合并前先用 Find Usages 确认所有相似段落
靠肉眼找“看起来一样”的代码容易漏掉变形写法，比如一处是 if !user.IsActive，另一处是 if user.Status != "active"。GoLand 的 Find Usages（右键 → Find Usages 或 Alt+F7）能帮你定位所有调用点，但前提是这些代码已封装成函数或方法。
- 先对其中一段做最小化提取：哪怕只提取一个空壳函数
checkPermStub()，立刻就能用Alt+F7扫出所有调用位置 - 对返回值不一致的段落，先临时改成相同签名：比如都返回
(bool, error)，哪怕某处实际只用bool，避免提取时报 “conflicting return types” - 若发现某处调用传参顺序不同（如
check(a, b)vscheck(b, a)），说明语义不等价，强行合并会引入 bug
提取后务必跑一次 go test -run=^Test.*Perm
合并逻辑本身不会改变行为，但重构过程中的变量重命名、参数顺序调整、错误处理路径收窄，都可能让原本被掩盖的 panic 或 nil dereference 浮现出来。特别是当原代码有 recover() 或 if err != nil { return } 这类防御逻辑时，提取后若忘记保留，测试会直接挂掉。
- 别只信 IDE 的 “Preview changes”：它不校验运行时行为，只比对 AST 节点替换
- 重点关注边界 case：比如用户 ID 为空、权限字段为 nil、数据库连接超时等原分散在各处的错误分支，是否在新函数里被统一处理或意外吞掉
- 如果项目启用了
GO111MODULE=on但本地go.sum未更新，go test可能因依赖版本不一致而行为突变，此时先go mod verify
