写完业务代码只是开发的一部分,单元测试、技术注释和提交说明等配套内容同样消耗时间。Cursor 可以将这些工作流自动化,让你专注于核心逻辑,同时保持项目规范。
3.7.1 单元测试用例生成
给模块补充测试时,不必从零开始写 Arrange-Act-Assert。选中目标函数或类,按 Ctrl/Cmd + K 输入提示如:"为这段代码生成 Jest 单元测试,覆盖正常输入、空值和边界条件",Cursor 会基于当前代码结构生成对应的测试文件内容。
如果项目已有测试目录和规范,建议通过 @文件 引用现有的测试基类或工具函数(如 test/utils.ts),让 AI 生成的测试代码直接遵循既有风格。生成后,重点检查 AI 是否正确处理了外部依赖的 Mock(如数据库调用、HTTP 请求),这部分目前仍需人工兜底。
3.7.2 技术文档与注释生成
对于需要交接或长期维护的代码,选中函数后使用 "Add Docstring"(或行内输入 "生成 JSDoc"),AI 会自动提取参数、返回值和异常信息,生成标准化注释。如果代码内含复杂业务规则,可以先让 AI 用自然语言解释一遍,确认理解无误后再转换为注释,避免文档与实现不符。
在需要撰写 README 或模块说明时,可将核心文件通过 @文件 引入侧边栏,指令如:"根据这两个文件的功能,生成一段面向后端开发者的 API 调用说明"。Cursor 会结合代码中的类型定义和路由信息输出文档草稿,你只需补充业务背景即可。
3.7.3 代码提交说明自动编写
在 Source Control(源代码管理)面板中,Cursor 会检测暂存区的变更内容,在提交消息输入框旁提供 AI 生成按钮(部分版本需手动触发)。点击后,AI 会根据 git diff 自动总结改动点,生成符合 Conventional Commits 规范的提交说明,例如 feat(user): add email validation 或 fix(api): handle null pointer exception。
你也可以在终端执行 git diff --cached 后,通过 @终端 将 diff 结果引入侧边栏,自定义提示词如:"用中文生成简短的提交说明,列出主要修改和潜在风险"。
实用提醒
- 生成测试和文档时,建议先保存当前文件,确保 AI 读取的是最新代码内容;
- 自动生成的 commit message 在大批量重构时容易过于笼统,可要求 AI 分点列出主要变更后再手动精简;
- 涉及敏感配置或密钥的 diff 不要直接发送给 AI 生成提交说明,避免信息泄露风险。