go-modern-guidelines

给 AI 代理装上 Go 现代编码规范，生成代码更地道

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3866

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类编程开发

开发团队JetBrains

所属国家

官网地址

GitHubhttps://github.com/JetBrains/go-modern-guidelines

定价模式free

价格说明开源免费

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型ai-agents,coding-agent,developer-tools,go,golang,guidelines

GitHub 星标★ 3866

30天Star增速

HF 下载量

上线时间2025-11-24 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-18

浏览次数0

项目介绍

go-modern-guidelines 是一份面向 Go 语言的开源编码规范指南，专门用于指导 AI 编程代理（如 Claude Code、Cursor、Copilot 等）写出符合现代 Go 风格的代码。它解决的核心问题是：AI 生成的 Go 代码常常沿用旧习惯或通用模式，出现过度使用 interface、错误处理啰嗦、包命名混乱、并发用法不当等问题。项目以结构化规则文档的形式，把 Go 社区沉淀的最佳实践（如错误包装、context 传递、避免 goroutine 泄漏、合理使用泛型等）整理成 AI 可直接读取的指令集，让代理在生成或重构代码时遵循统一风格。核心能力包括：覆盖语法、并发、错误处理、包设计、测试与性能等多维度规则；可直接作为 AI 代理的系统提示或规则文件接入；内容随 Go 版本演进持续更新。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 8 分钟部署方式：命令行工具 7 步

环境要求

已安装并可使用 Claude Code、Codex 或 Cursor 中的至少一个编码代理
能在代理会话内执行斜杠命令（Claude Code、Cursor），或能在终端执行 codex / cursor-agent 命令
目标项目最好是 Go 项目并带有 go.mod，代理据此判断可用的 Go 版本特性

安装与启动步骤

1选择你的代理平台

README 分别给出 Claude Code、Codex、Cursor 三种安装方式，选一个你正在用的平台照做即可，不必全部安装。
2Claude Code 添加市场

在 Claude Code 会话内执行，把 JetBrains 仓库加为插件市场，注意是会话内斜杠命令而非系统终端。
```
/plugin marketplace add JetBrains/go-modern-guidelines
```
3Claude Code 安装插件

紧接着在同一个会话内安装 modern-go-guidelines 插件，装好后处理 Go 任务时会自动生效。
```
/plugin install modern-go-guidelines@goland-claude-marketplace
```
4手动触发规范技能

如果代理没有自动调用，可在 Claude Code 会话中显式调用该技能，让规范在本次任务中生效。
```
/modern-go-guidelines:use-modern-go
```
5Codex 安装插件

在系统终端依次执行两条 codex 命令：先添加市场，再安装插件，第二条命令的参数含市场名。
```
codex plugin marketplace add JetBrains/go-modern-guidelines
codex plugin add modern-go-guidelines@goland-codex-marketplace
```
6Cursor 添加市场

在终端用 cursor-agent 命令把 GitHub 仓库地址添加为插件市场，注意此处需要完整的 https 地址。
```
cursor-agent plugin marketplace add https://github.com/JetBrains/go-modern-guidelines
```
7Cursor 会话内安装

回到 Cursor 会话中执行 /plugins 命令，在插件列表里选择并安装 modern-go-guidelines。
```
/plugins
```

关键配置

配置项	必填	说明	示例
`go.mod 中的 go 版本`	是	代理读取该版本，决定允许使用到哪个 Go 版本的语法与标准库特性	`go 1.24`

如何确认成功

让代理完成一个 Go 小任务，观察其是否使用 slices.Contains、max(a, b) 等现代写法；或手动触发 /modern-go-guidelines:use-modern-go 看是否有响应。

常见问题

Q：安装后代理没有按规范写代码怎么办？

A：Claude Code 中可显式执行 /modern-go-guidelines:use-modern-go 手动调用技能；同时确认项目 go.mod 存在且 Go 版本正确，否则代理可能无法判断可用特性。

Q：三个平台的插件可以只装一个吗？

A：可以。README 为 Claude Code、Codex、Cursor 分别给出安装方式，按你实际使用的代理选择其中一种即可，无需全部安装。

Q：为什么我的项目里看不到现代写法？

A：规范按 go.mod 声明的 Go 版本生效，若版本较低则不会建议更高版本才有的特性；可升级 go.mod 中的 go 指令后重试。

Q：Cursor 的第二步在哪里执行？

A：第一步 cursor-agent 命令在系统终端执行，第二步 /plugins 需在 Cursor 会话内部执行，两者环境不同不要混淆。

注意事项

Claude Code 与 Cursor 的安装命令需在代理会话内输入，Codex 与 cursor-agent 命令在系统终端执行。
插件只是给代理的指令集，不会自动修改你的代码，最终是否采用现代写法由代理在生成时决定。
想了解每条规则覆盖的具体特性，可查看仓库中的 FEATURES.md。

核心亮点

规则按主题结构化组织，AI 代理可直接读取作为系统提示或规则文件，接入成本低
覆盖错误处理、并发、包设计、泛型等 Go 高频踩坑点，针对 AI 生成代码的常见坏习惯
以文档形式维护，不绑定具体 AI 工具，Claude Code、Cursor、Copilot 等均可复用

不足之处

本质是规则文档而非可执行工具，缺少自动校验或 lint 集成，效果依赖代理是否遵守
规则覆盖面与 Go 版本演进需持续人工维护，社区贡献流程和更新节奏待观察

适用场景

在 Claude Code 或 Cursor 中配置为项目规则，约束 AI 生成的 Go 代码风格
团队用 AI 辅助重构遗留 Go 项目时，统一输出代码的现代写法
为新 Go 项目编写 AI 编码代理的初始提示词，减少后期 code review 返工

替代项目

uber-go/guide、golang-standards/project-layout

上一篇：git-ai

下一篇：github-copilot-agent-skills