现代 Go 语言指南本仓库包含适用于代码智能助手的指南旨在帮助它们编写符合现代标准的 Go 代码。例如遵循这些指南的智能助手会使用 max(a, b) 而非 if - else 代码块使用 slices.Contains 而非手动循环使用 cmp.Or(a, b, c) 而非一连串的空值检查。它还了解 Go 1.26 引入的新特性如 new(42) 用于获取值的指针以及 errors.AsType[T](err) 用于类型安全的错误匹配。这些指南涵盖了从 Go 1.0 到 Go 1.27 中最实用的特性包括 modernize 分析器所针对的所有内容。智能助手将从 go.mod 文件中检测项目的 Go 版本。使用该版本及之前版本可用的语言特性和标准库新增功能。优先采用现代编程习惯用法而非旧模式。动机所有代码智能助手生成的 Go 代码往往较为陈旧主要有两个原因训练数据滞后模型不了解训练截止日期之后添加的特性。如果它们从未见过 errors.AsType[T]Go 1.26就无法使用该特性。频率偏差即使模型知道某些特性也常常会选择旧模式。训练数据中 for i : 0; i n; i 的出现频率高于 for i : range n因此输出的往往是前者。这些指南通过为智能助手提供明确的参考解决了上述两个问题这与 Go 团队的发展方向一致。modernize 分析器用于自动更新现有代码以采用新的编程习惯用法可参考 Go 团队的相关演讲。这些指南对于新代码也有同样的目标让智能助手从一开始就编写符合现代标准的 Go 代码从而减少后续的修改工作。要求市场集成会运行一个小型的命令行工具CLI首次使用时可通过 go install 进行安装。因此必须安装 Go 工具链并将其添加到系统的 PATH 环境变量中。该 CLI 会安装到本地缓存目录例如 ~/.cache/go - modern - guidelines且不会修改你的项目。它支持 Go 1.25 及更高版本在较旧的 Go 版本上只要启用了自动工具链切换GOTOOLCHAIN auto默认设置仍然可以正常工作这允许 Go 在首次运行时获取兼容的工具链。安装说明这些指南适用于 Junie、Claude Code、Codex 和 Cursor 等智能助手也可通过 skills.sh 供其他智能助手使用。Junie安装在 Junie CLI 会话中运行以下命令。将本仓库添加为市场源/extensions marketplace add JetBrains/go - modern - guidelines安装扩展/extensions install modern - go - guidelinesJunie 在处理 Go 相关任务时会自动调用该技能。更新在 Junie CLI 会话中更新已安装的扩展/extensions update modern - go - guidelinesClaude Code安装在 Claude Code 会话中运行以下命令。将本仓库添加为市场源/plugin marketplace add JetBrains/go - modern - guidelines安装插件/plugin install modern - go - guidelinesgoland - claude - marketplace使用Claude Code 在处理 Go 相关任务时会自动调用该技能。若要手动调用/modern - go - guidelines:use - modern - go更新Claude Code 可在启动时自动更新市场源和已安装的插件。第三方市场源的自动更新默认是禁用的因此需要手动启用一次运行 /plugin打开市场源列表选择 goland - claude - marketplace然后选择“启用自动更新”。当 Claude Code 提示插件已更新时使用 /reload - plugins 命令将新版本应用到当前会话。若要手动更新可在终端中运行以下命令claude plugin marketplace update goland - claude - marketplaceclaude plugin update modern - go - guidelinesgoland - claude - marketplaceCodex安装在终端中运行以下命令。将本仓库添加为市场源codex plugin marketplace add JetBrains/go - modern - guidelines安装插件codex plugin add modern - go - guidelinesgoland - codex - marketplace更新刷新市场源并重新安装插件以便 Codex 替换其缓存副本codex plugin marketplace upgrade goland - codex - marketplacecodex plugin remove modern - go - guidelinesgoland - codex - marketplacecodex plugin add modern - go - guidelinesgoland - codex - marketplaceCursor为方便使用这些指南以 Cursor 插件的形式分发。安装在终端中运行以下命令将本仓库添加为市场源cursor - agent plugin marketplace add https://github.com/JetBrains/go - modern - guidelines然后在 Cursor 会话中使用 /plugins 命令安装插件。更新从 Git 刷新市场源并重新打开 Cursor以便它能获取新的插件版本cursor - agent plugin marketplace update goland - cursor - marketplace。如果已安装的插件仍为旧版本可使用 /plugins 命令重新安装。目前 Cursor 没有提供非交互式的 CLI 命令来更新已安装的插件。其他智能助手通过 skills.sh相同的技能包可用于其他智能助手如 OpenCode。安装使用以下命令进行安装npx skills add JetBrains/go - modern - guidelines--skill use - modern - go 仅安装此技能。更新更新项目级安装的技能npx skills update use - modern - go - p - y对于全局安装的技能将 -p 替换为 -g。本地开发若要在智能助手中测试 CLI 的更改可将当前代码检出构建到工具的缓存中make dev - install。然后在智能助手运行的环境中设置 GO_MODERN_GUIDELINES_DEV 1。设置该环境变量后使用该插件的任何智能助手都会运行你本地的构建版本而非发布版本Claude Code、Codex 和 Cursor 都是如此。在启动智能助手之前导出该变量以便智能助手进程继承该设置export GO_MODERN_GUIDELINES_DEV 1。编辑 CLI 后再次运行 make dev - install 进行重建下次调用时将使用新的构建版本。若要恢复到发布版本可取消设置该变量或运行 make dev - uninstall 移除本地构建make dev - uninstall。这需要安装 Go 工具链。开发版本的构建文件存储在工具的缓存目录$XDG_CACHE_HOME/go - modern - guidelines 或 ~/.cache/go - modern - guidelines中。构建过程由 scripts/dev - install.sh 脚本驱动该脚本与面向智能助手的包装器有意分开以确保智能助手不会触发构建。如果没有 make 工具例如在 Windows 系统上可以直接运行脚本sh scripts/dev - install.sh install或 uninstallpwsh scripts/dev - install.ps1 installPowerShell 等效命令