GoLand支持将顶层struct或interface通过「Extract Type」重构提取到新文件，自动创建文件、添加package、更新import和引用；但不支持直接提取函数到新文件，需手动操作。
提取结构体或接口到新文件
GoLand 不支持直接把一段代码“提取为新 .go 文件”，但对类型定义（如 struct、interface、type 别名）有专门的「提取类型」重构。它会自动创建新文件，把选中的类型定义移过去，并在原位置替换成 import 和引用。
操作前注意：目标类型必须是顶层声明（不能嵌套在函数内），且当前文件需属于一个有效的 Go module（即目录下有 go.mod）。
- 将光标放在要提取的类型名上（例如
type User struct的User上），或选中整个type ... struct块 - 按
Ctrl+Alt+Shift+T（Windows/Linux）或Cmd+Option+Shift+T（macOS），选择「Extract Type」 - 在弹出对话框中输入新文件名（如
user.go），GoLand 会自动补全路径并建议放在./internal/或同级目录 - 确认后，它会：创建新文件、移动类型定义、添加
package声明、在原文件加 import、更新所有引用
提取函数到新文件不被直接支持
GoLand 没有「Extract Function to New File」这个重构选项。如果你选中一个函数体并尝试提取，IDE 只会提供「Extract Method」（转成接收者方法）或「Extract Variable」等，不会生成新文件。
常见误操作：想把 func calculate(...) 拖到新文件里——这只能手动做。强行用「Move」重构（F6）会失败，因为函数不是“可移动的顶级符号”（GoLand 当前只支持移动类/变量/函数在 JS/TS 中，不支持 Go 函数）。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 正确做法是：新建
util.go（右键目录 → New → Go File），手动复制函数，补上package main（或对应包名） - 如果该函数需跨包使用，必须导出（首字母大写），且目标文件不能是
main包（否则无法 import） - 别忘了检查函数依赖的其他类型或变量是否也在同一包内；否则要一并迁移或调整 import
同包多文件时的命名与组织陷阱
GoLand 允许你在同一 package main 下建多个 .go 文件（比如 main.go、cmd_add.go、cmd_list.go），这是合法且推荐的 CLI 项目结构。但提取操作不会自动帮你做这件事。
容易踩的坑是：手动拆分后忘记统一包名，或把本该同包的文件错放到子目录导致变成独立包，引发 undefined: xxx 错误。
- 所有同包文件必须声明相同的
package xxx，且不能有子目录（即不能是cmd/add.go，除非你打算定义package add） - 如果原函数依赖
main.go里的全局变量，拆出去后变量不可见，得改成参数传入或提升为包级变量（并注意并发安全） - GoLand 的「Find Usages」对同包跨文件引用识别良好，但「Rename」重构默认只作用于当前文件——要改全包，得手动选中「All places in package」作用域
替代方案：用「Move」重构 + 手动调整
当你要迁移的是一组相关类型+函数（比如一个 domain 模块），可以先用「Extract Type」把核心 struct 提出来，再手动把配套方法、常量、工具函数复制到同一新文件——这是目前最可控的方式。
关键点在于：GoLand 的重构能力集中在「安全变更」上，而跨文件移动逻辑涉及语义判断（比如方法接收者是否还有效、import 是否闭环），它选择不做自动推断，交由开发者确认。
- 不要依赖「Move」快捷键去拖函数，它大概率报错或静默失败
- 新建文件后，用
Ctrl+Space触发 import 补全，避免手写错包路径 - 改完立刻运行
go build，比等 IDE 报错更早发现循环 import 或未导出问题
