goland 的模块重命名重构需先启用 go modules 模式，再对 go.mod 中 module 行使用 shift+f6 触发跨文件路径修正，但不改目录名，需手动同步文件夹名并更新 replace 和外部引用。
go.mod 文件里的 module 声明不能靠“重命名文件夹”或“改目录名”来同步更新——那样只会让所有 import 语句失效，构建直接报错 can't load package: local import "./xxx" in non-local package。
GoLand 提供的是**安全的模块重命名重构功能**，但前提是项目已启用 Go Modules 且 gopls 正常工作。它不是“一键改名”，而是“一键触发跨文件路径修正”。
确认项目处于 Go Modules 模式
这是前提，否则 Shift+F6 对模块名根本不可用：
- 项目根目录必须存在
go.mod文件；若没有，终端执行go mod init example.com/oldname - GoLand 设置中开启：Settings → Go → Go Modules → ✅ Enable Go modules integration
- 确保
GO111MODULE=on生效（go env GO111MODULE应输出on）
在 go.mod 中对 module 行使用 Shift+F6
这是唯一能触发全自动重构的方式。光标停在 module 后面那一行的模块路径上（比如 module github.com/user/oldproject），按 Shift+F6：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 弹出重命名窗口，输入新路径，如
github.com/user/newproject - 勾选 “Search in comments and strings” —— 必须勾，否则
// import "github.com/user/oldproject"这类注释不会被更新 - 点击 “Refactor”，GoLand 会自动扫描并批量修改：
go.mod、所有import语句、replace指令、甚至测试文件中的_test.go引用 - 注意：它**不会**自动改文件系统目录名，只改代码逻辑路径
重命名后必须手动同步 import 路径与文件系统结构
Go 的 import 路径必须和磁盘路径可映射。模块名变了，但文件夹还叫 oldproject，会导致 go build 找不到包：
- 先完成上一步的重构，再手动重命名项目根目录（例如从
oldproject/改为newproject/） - 如果用了
replace指向本地路径（如replace github.com/user/oldproject => ../oldproject），记得同步更新为=> ../newproject - 运行
go mod tidy清理无效依赖，并验证go list ./...是否全部成功
跨包调用不被自动处理，最容易漏掉
gopls 的重构只作用于当前模块内。如果你的 newproject 被其他外部模块（比如同事的 repo）import，那些地方的 import "github.com/user/oldproject" 不会自动变：
- 这类引用必须由对方手动更新，你无法控制
- 发布新版本时，应在 CHANGELOG 或 README 明确写：“模块路径已从
github.com/user/oldproject迁移至github.com/user/newproject” - 短期兼容可加
replace到旧路径（仅限开发），但正式发布前必须移除
go build 就立刻报错，而且错误信息往往指向最末尾的 import 行，容易误判根源。
