gopls默认仅在当前包内重构，跨包不自动更新；重命名需光标精准定位标识符、文件无语法错误且go.mod有效；extract function仅作用于当前文件选中代码块，不跨文件插入调用。
重命名符号时，为什么只改了当前文件？
因为 gopls 默认只在当前包（package）内做跨文件引用更新。如果你在 main.go 里重命名一个函数，而调用它的地方在 handler/user.go，只要两者属于同一包（比如都是 main），Shift+F6 就能自动更新；但若调用方在另一个包（如 service），则不会动——这不是 bug，是设计限制。
常见错误现象：Rename Symbol 菜单项灰掉、右键没反应、或弹出提示“no references found”。
- 光标必须停在标识符**正中间**（比如变量名
userName的u或s上），不能在空格、点号、括号或注释里 - 目标标识符必须被
gopls正确解析：无语法错误、所有 import 可 resolve、go.mod中依赖能go list -m all成功拉取 - 跨包重命名不支持自动传播，需手动检查调用处并同步修改（或配合
go mod vendor+ 全局 grep）
Extract Function 后，调用它的其他文件没变？
Extract Function 是局部重构，只作用于当前文件当前函数体内选中的代码块。它不会、也不能自动在其他文件中插入新函数调用——那会改变程序行为，违背重构定义。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
使用场景：你有一段重复逻辑在 api/login.go 的两个 handler 里，想抽成 validateToken()。抽完后，该文件里原来的两处逻辑会被替换成 validateToken() 调用，但 api/register.go 里哪怕有相同代码，也不会被识别或替换。
- 选中的代码块不能含
return、break、defer或跨函数边界（比如从for开始选到if外） - 抽出来的函数默认是 unexported（小写开头），其他包无法直接调用；要跨包复用，得手动改成 exported（大写开头）并确保所在包已正确 import
- 如果原逻辑涉及闭包变量（如捕获了
req *http.Request），提取后参数列表会自动补全，但你要确认这些参数在其他调用上下文中是否可得
如何让跨包引用也跟着更新？
没有一键方案。Go 的模块边界和导出规则决定了跨包重构必须人工介入。但你可以用组合策略降低出错率：
- 先在目标包内完成重命名或提取，确保新符号已 export 并通过
go test ./...验证 - 用
go mod graph | grep your-module粗略看依赖流向，再用git grep "OldFuncName" ./...扫描整个 repo（注意排除 vendor 和 testdata） - 对每个匹配结果，打开文件，手动替换为新名；若数量多，可用
sed -i '' 's/OldFuncName/NewFuncName/g' $(git grep -l "OldFuncName")（macOS）或sed -i 's/OldFuncName/NewFuncName/g' $(git grep -l "OldFuncName")（Linux）批量处理，但务必先备份或走 git stash - 最后跑一遍
go build ./...和go vet ./...，确保没漏掉类型不匹配或未导出访问
最易被忽略的一点：重构前没确认 go.mod 是否真正生效。即使有文件，若 GO111MODULE=off 或项目根目录不对，gopls 就退化为纯语法分析器，所有跨文件引用识别都会失效。
