Cursor Rules怎么配置提交信息规范?

冰火之心

冰火之心

2026-07-31

762人浏览

原创

cursor 自动生成中文 git 提交信息需在项目根目录创建 .cursor/rules/ 目录并写入 commit-message-format.mdc 文件,文件中强制要求使用简体中文、conventional commits 格式、祈使语气且不翻译代码实体,仅该路径下的 .mdc 文件生效。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

cursor rules怎么配置提交信息规范?

让 Cursor 在 Git 提交时自动生成符合团队规范的中文提交信息,而不是英文或语义模糊的描述,必须通过项目级规则文件明确约束其语言、格式与内容范围。

创建项目级规则目录结构

在项目根目录下执行命令:mkdir -p .cursor/rules。这一步不可跳过,因为 Cursor 只识别 【.cursor/rules/ 目录下的 .mdc 文件】 作为项目级提交规范源;若目录不存在,AI 将完全忽略所有 commit-message 配置。

确认该目录已存在且路径为 ./.cursor/rules/(注意开头是点号),不是 .cursorrulescursor/rules

写入中文提交消息强制规则

.cursor/rules/ 目录中新建文件 commit-message-format.mdc,粘贴以下内容:

Cursor 2.4
Cursor 2.4

Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。

下载

```markdown
---
id: commit-message-format
trigger: git-commit
---
**CRITICAL INSTRUCTION — READ CAREFULLY**
You **MUST** write all commit messages in **Simplified Chinese**.

Follow Conventional Commits format:
- `feat`: 新功能
- `fix`: 修复 Bug
- `docs`: 文档更新
- `style`: 格式调整(无逻辑变更)
- `refactor`: 重构
- `test`: 测试增补或修改
- `chore`: 构建/工具配置变更

Do **NOT** translate code entities: `UserService`, `handleError`, `main.py`, `API`, `JSON`, `React`, `LLM` are kept in English.

Use imperative mood: “添加登录校验” not “已添加登录校验”。
Keep subject line under 50 characters.
Do **NOT** include changes to `.cursor/rules/*.mdc` files in the message.
```

保存后,该规则即刻生效——下次使用 Cursor 的 “Generate Commit Message” 功能时,AI 将严格按此指令输出中文内容。

验证并覆盖默认行为

第一步:确保暂存区有修改(例如改一个 JS 文件并执行 git add .);
第二步:在 Cursor 中按 Cmd+K(Mac)或 Ctrl+K(Windows/Linux)唤出命令面板;
第三步:输入 “Generate Commit Message” 并回车;
第四步:观察生成结果是否以中文开头、含 Conventional Commits 前缀(如 fix:)、且未混用英文动词(如 “add” “update”)。

若仍出现英文,检查是否误将规则文件放在 .cursor/rules.yamlUser Rules 设置中——这两种位置均不支持 commit-message 格式强制,只有 .cursor/rules/*.mdc 能触发该行为。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

cursor cursor rules编写

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
marquee参数有哪些
marquee参数有哪些

marquee参数有direction、behavior、speed、scrolldelay、width、height、bgcolor、cursor、id、align、noresize、nohover、loopcount、bgcolorcolor、scrollamount和vspa。

2023.10.18

578

10

Cursor新手入门教程
Cursor新手入门教程

这是一份为新手量身定制的 Cursor 入门全流程指南。无论你是刚从 VS Code 迁移过来的老手,还是编程小白,这份指南都能帮你快速上手这款“代码自动驾驶仪”。

2026.04.09

49

10

Cursor 核心功能深度解析与实战技巧
Cursor 核心功能深度解析与实战技巧

本专题深度剖析 AI 代码编辑器 Cursor 的核心功能,涵盖 Composer 模式、codebase 索引、实时代码预测(Tab)及 Chat 交互等进阶用法。通过丰富的实战案例,手把手教你如何利用 Cursor 快速构建应用、重构复杂代码及进行自动化 Debug。

2026.04.16

112

10

Cursor 针对不同开发场景的使用教程
Cursor 针对不同开发场景的使用教程

本专题深度拆解 Cursor 在前端 UI 开发、后端重构、数据爬虫及自动化测试等 10+ 核心场景下的具体用法。详解如何针对不同业务场景配置特定的 .cursorrules,让 AI 真正深入你的业务逻辑。

2026.04.16

60

10

Selenium WebDriver元素定位与页面操作教程
Selenium WebDriver元素定位与页面操作教程

本专题整理Selenium WebDriver元素定位、XPath、CSS Selector、等待机制、窗口切换、Frame处理、Alert弹窗、Cookie操作和文件上传等核心用法。

2026.08.05

0

26

Selenium Grid分布式测试与并行执行教程
Selenium Grid分布式测试与并行执行教程

本专题整理Selenium Grid架构、远程WebDriver、并行测试、Docker部署、Kubernetes动态Grid、浏览器矩阵和测试环境扩展方法,适合进阶自动化测试团队使用。

2026.08.05

0

18

Selenium常见报错排查与自动化测试稳定性
Selenium常见报错排查与自动化测试稳定性

本专题整理Selenium常见报错、驱动版本问题、元素找不到、点击失败、等待超时、浏览器闪退、脚本不稳定和测试用例维护方法。

2026.08.05

0

17

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

11

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

8

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Cursor 使用手册
Cursor 使用手册

共0课时 | 0人学习