没有“一键安全重构”，必须分层识别、分步处理：先用goland静态分析定位垃圾代码，再按删→提→改三步安全拆解，跨包重构依赖gopls lsp能力，编译验证不可跳过。
没有“一键安全重构”这种操作。所谓大段垃圾代码，必须分层识别、分步处理，否则轻则功能错乱，重则编译失败。
为什么不能直接选中整块代码按 Extract Function
GoLand 的 Extract Function（Ctrl+Alt+M）只接受语义合法、边界清晰的代码块：它要求选中内容必须是完整表达式或语句序列，且不能跨函数作用域、不能含裸 return、不能破坏控制流（如中断 if 或 for 结构）。你随手圈出的“垃圾代码”，常见问题包括：
- 开头是
if err != nil { return }，结尾在另一个if块里 —— 这不是可提取的逻辑单元 - 混着变量声明、赋值、条件判断、日志打印 —— 缺乏单一职责，强行提取会把错误处理、业务逻辑、副作用全塞进一个函数
- 引用了外层函数的多个局部变量，但没显式传参 —— 提取后编译报错
undefined: xxx
先用 GoLand 快速定位“真垃圾”，再动手
别靠肉眼扫，用 IDE 自带的静态分析能力筛出高风险区：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 打开
Code→Inspect Code，范围选整个包，重点看Go | Unused parameter、Go | Unreachable code、Go | Redundant assignment这几类警告 - 对函数右键 →
Find Usages，结果为 0 的函数大概率可删（但得确认是否被反射调用或插件注册） - 打开
Structure工具窗口，排序按 “Length”，一眼揪出超长函数；点开后看Code Completion是否频繁标红未解析标识符 —— 那说明这段代码本身已不可用
安全拆解三步走：删 → 提 → 改
面对一段 200 行的 handleRequest，别想着一气呵成。按顺序做：
-
删：先删确定无用的部分。用
Optimize Imports（Alt+Enter）清掉未用包；手动删掉注释掉的代码块（GoLand 会标灰，但不会自动删）；对log.Printf后紧跟return的调试残留，直接剪掉 -
提：从最外围剥离副作用。比如日志、指标打点、panic 捕获，选中它们 →
Extract Function→ 命名为logAndTrace或recoverPanic；再对纯计算部分（如 JSON 解析 + 字段校验）单独提取，确保新函数只接收参数、只返回 error -
改：最后动主干。把原函数里剩下的逻辑，按数据流向拆成
parseInput→validate→execute→formatResponse；每步提取后立刻运行测试，不通过就回退 ——Ctrl+Z比修复崩溃快得多
跨文件/跨包重构时，gopls 是唯一可信的帮手
如果你要重命名一个被 5 个包引用的结构体字段，或者把某个工具函数从 utils 移到 internal，仅靠 GoLand 界面操作极可能漏掉 import 路径或别名。必须依赖 gopls 的 LSP 能力：
- 确保
gopls已安装且版本 ≥ v0.15.0：gopls version可查 - 光标停在要重命名的标识符上，按
Shift+F6，勾选Search in comments and strings（谨慎！只在确认无歧义时勾） - 若目标符号在其他模块（如
github.com/xxx/lib），gopls不会自动改 —— 它只管当前 workspace。此时需手动检查所有go.mod依赖是否为 replace 模式，否则 rename 操作根本不会出现在菜单里
真正容易被忽略的是：重构后第一次 go build 报的错，往往不是语法问题，而是类型不匹配 —— 比如你把 int 参数改成 int64，但调用方还在传 int，而 GoLand 不会高亮这种隐式转换失败。这类问题只能靠编译器兜底，别跳过这一步。
