Alt+Enter 仅在函数被 // Deprecated: 注释标记且 Go SDK 版本匹配时触发替换提示；支持 ioutil 到 os/io 的迁移及含弃用注释的第三方 API，批量替换需用 Ctrl+Shift+Alt+T。

Alt+Enter 不能直接“替换写法”，它只触发意图操作（intention action），是否出现“Replace with xxx”选项，取决于 GoLand 是否识别出该 API 已被标记为 deprecated。

为什么 Alt+Enter 有时没反应？

不是所有旧函数调用都会弹出替换建议。GoLand 的替换提示依赖两个前提：

• 标准库或你使用的第三方包中，目标函数必须带有 // Deprecated: 注释（Go 官方自 Go 1.16 起强制要求）
• 你的 Go SDK 版本需 ≥ 对应废弃声明的版本（例如 ioutil.ReadFile 在 Go 1.16+ 才被标记废弃）
• 项目未开启 GO111MODULE=off 或模块路径解析异常时，IDE 可能无法加载正确文档，导致意图缺失

哪些函数能触发 Replace with os.ReadFile 这类提示？

目前稳定支持的替换对集中在 ioutil 包迁移场景：

• ioutil.ReadFile → os.ReadFile
• ioutil.WriteFile → os.WriteFile
• ioutil.TempDir → os.MkdirTemp
• ioutil.TempFile → os.CreateTemp
• ioutil.ReadAll → io.ReadAll（注意：不是 bytes.ReadAll）

第三方包如 golang.org/x/net/context 中的 Deadline 方法，若其文档含 Deprecated:，也会触发类似提示；但多数自定义函数不会自动获得此能力。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

批量替换整个文件的过时 API

单点 Alt+Enter 只改当前行。要全文件批量处理：

• 按 Ctrl+Shift+Alt+T（macOS 是 ⌘⇧⌥T），打开「Refactor This」菜单
• 若检测到多个 deprecated 使用，会出现 Replace deprecated API usage 项；否则该选项灰显
• 选中后，GoLand 会列出所有可替换位置，并允许你勾选/取消特定项，再统一执行
• 注意：它不会跨文件处理，也不修改注释或字符串中的疑似调用（比如 "ioutil.ReadFile" 不会被动替换）

替换了但编译失败？检查这三点

常见翻车点不在替换动作本身，而在后续适配：

• os.ReadFile 返回 []byte, error，而旧版 ioutil.ReadFile 也一样——类型无变化，但部分老代码可能误用了 string(...) 强转，需手动检查
• os.WriteFile 第三个参数是 fs.FileMode，不再是 os.FileMode 别名（Go 1.16+），若你传了 0644 字面量没问题，但若用了 os.FileMode(0644)，需改为 fs.ModePerm 或保留字面量
• 替换后记得按 Ctrl+Alt+O 优化导入——os 和 io 包可能未自动引入，而 ioutil 导入未被自动删除

最易被忽略的是：替换仅发生在 AST 层，不触碰测试文件、mock 实现、文档示例里的硬编码调用。这些得靠 Ctrl+Shift+R 手动搜 ioutil\. 正则匹配补全。