不能直接用Ctrl+R改函数签名，因为它仅做文本替换，会破坏参数顺序、类型和命名，导致编译错误或panic；应使用语义级重构Ctrl+F6（Win/Linux）或Cmd+F6（macOS），光标需停在函数定义的名称上，确保同步更新所有调用、实现及接口。
GoLand 里改函数签名为什么不能直接 Ctrl+R？
直接用 Ctrl+R（Windows/Linux）或 Cmd+R（macOS）做普通文本替换会破坏调用处的参数顺序、类型、命名，尤其当函数被多处调用、有重载（虽 Go 没重载但方法集/接口实现易混淆）、或参数含匿名结构体时，极易引入编译错误甚至运行时 panic。GoLand 的「Change Signature」是语义级重构，它能同步更新所有调用点、方法集实现、接口满足检查，前提是代码能通过 go/types 类型检查。
触发 Change Signature 的正确入口
光标必须停在函数名上（不是括号内、不是调用处），然后按：
• Windows/Linux：Ctrl+F6
• macOS：Cmd+F6
如果没反应，大概率是光标位置不对——试试把光标移到 func foo 的 foo 上，而不是 foo() 调用里的 foo。
- 不支持在函数调用处触发；只能在定义处（
func关键字后紧跟的标识符） - 如果函数是方法（如
func (r *Repo) Save()），光标需落在Save上，而非Repo - 若项目未正确加载 Go modules（
go.mod缺失或GOROOT/GOPATH配置异常），该功能会灰掉或报Cannot resolve function signature
修改参数时最常踩的三个坑
在弹出的对话框里操作参数列表，表面简单，实则细节决定是否安全：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
加参数别漏设默认值：新增参数后，所有已有调用会报错。GoLand 不会自动补零值，你得手动在「Default value」栏填上
nil、""、0或有效表达式（如context.Background()），否则重构无法提交 -
删参数前先确认无间接依赖：比如参数是
io.Reader，而某处传的是bytes.NewReader([]byte{})，删掉后调用点消失，但若该 reader 还被闭包捕获或用于 defer，静态分析可能漏判 -
改参数名 ≠ 改变量名：「Name」列改的是函数签名里的形参名；但函数体内原变量名不会变。例如把
func Do(x int)改成func Do(val int)，函数体里仍用x—— GoLand 不会重命名函数体内引用，得手动处理或配合Shift+F6单独重命名局部变量
重构后一定要看「Preview」和编译结果
点击「Refactor」前务必点左下角「Preview」，它会列出所有将被修改的文件和行。重点扫一眼：
• 接口实现是否还满足（比如 http.Handler 要求 ServeHTTP(w http.ResponseWriter, r *http.Request)，改错一个参数名就断掉）
• 方法集是否变化（导出方法签名变更会影响其他包的嵌入）
• 是否有泛型约束被破坏（如 func F[T any](x T) 改成 func F[T ~int](x T)，调用处类型推导可能失败）
关闭对话框后，立即执行 Build → Build Project（Ctrl+F9），别信绿色对勾——GoLand 的实时检查有时滞后，真实 go build 才算数。尤其注意 ./... 下子包里那些没被 Preview 列出但实际依赖该函数的文件。
