做开发的都知道，重复写代码、搭框架有多磨人。但自从用了 Cursor CLI，我项目里的不少活儿都变得轻松了。今天就来聊聊它在项目里的实用用法，还有那些容易掉进去的坑，新手老手都用得上。

一、项目刚启动？用它 10 分钟搭好架子

以前新建项目，光是建目录、配配置文件就得花小半天，现在有了 Cursor CLI，一行命令就能搞定。

就拿 React 项目来说，在终端里输入：

cursor-agent scaffold --lang react --features router,redux --output ./my-new-project

按下回车，你就看着终端里的光标飞快滚动，左侧的文件管理器里，src、public、components 这些文件夹一个个冒出来，不到 10 分钟，一个带路由、状态管理的基础框架就建好了。

生成的代码里，路由配置文件写得清清楚楚，连 404 页面都给你准备好了，package.json 里的依赖也自动配全了，直接 npm install 就能跑起来。我上次搭一个管理系统框架，用这招比平时节省了 2 个多小时。

二、写业务代码？让它帮你搞定重复活

开发的时候，总有些重复的活儿，比如写表单组件、列表渲染，用 Cursor CLI 能省不少事，关键是得会用参数。

1. 让生成的代码贴合项目风格

你项目里的组件都习惯用驼峰命名法，生成新组件时就加上 --context 参数：

cursor-agent code --context ./src/components/Table.js --prompt "写一个带搜索框的用户列表组件" --output UserList.js

这样生成的 UserList 组件，不仅 props 命名和 Table.js 保持一致，连事件处理的写法都如出一辙，几乎不用修改就能直接用。

2. 批量生成相似代码

如果需要多个类似的组件，比如不同的表单项，建一个 tasks.json 文件，写上要生成的内容：

[

"生成带验证的手机号输入框组件",

"生成带日期选择的生日输入组件",

"生成带下拉选择的性别组件"

]

然后执行命令：

cursor-agent batch --input ./tasks.json --output ./src/components/forms

一杯咖啡的功夫，三个组件就生成好了，格式统一，还自带验证逻辑。

三、测试和优化？它也是好帮手

项目快上线的时候，测试和优化少不了，Cursor CLI 在这方面也很给力。

生成单元测试不用愁，指定文件和测试框架就行：

cursor-agent test --target ./utils/format.js --framework jest

生成的测试用例特别全，不仅测正常情况，像空值、特殊字符这些边界情况都覆盖到了，比我自己写得还周全。

想检查代码性能？用 audit 命令：

cursor-agent audit --dir ./src --report performance.html

打开生成的报告，哪些地方有内存泄漏风险、哪些函数可以优化，看得明明白白，照着改就行。

四、这些注意事项，血的教训换来的

1. 管好额度，别关键时刻掉链子

免费用户每天只有 100 次调用机会，批量操作很容易用完。建议建个脚本监控额度：

# 保存为check-quota.sh

curl -s -H "Authorization: Bearer $CURSOR_TOKEN" https://api.cursor.com/v1/quota | jq '.remaining'

每天开工前跑一下，心里有数。

2. 开启缓存，省时间省额度

在项目根目录建个.cursorrc 文件：

[cache]

enabled = true

ttl = 86400

path = "./.cursor-cache"

这样重复生成相似代码时，会直接用缓存，既快又省额度，但记得把缓存目录加入.gitignore。

3. 注意 Node 版本，别让环境坑了你

我之前用 Node.js 14 版本，老是调用失败，换成 16.18.0 及以上版本就好了，用 nvm 切换很方便：

nvm install 16.18.0

nvm use 16.18.0

五、最后说句大实话

Cursor CLI 确实是个好工具，但也不是万能的，生成的代码还得自己过一遍，关键逻辑不能全指望它。不过用好了，确实能把我们从重复劳动里解放出来，多花点时间在核心业务上。

你在项目里用过 Cursor CLI 吗？有什么好用的技巧或者踩过的坑？欢迎在评论区聊聊，互相避坑。