Rules 文件必须放在项目根目录的 .cursor/rules.json 路径，文件名严格为 rules.json；需手动创建 .cursor 文件夹；内容为含 "rules" 数组的合法 JSON；修改后须通过命令面板执行 Cursor: Reload Rules 才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 Cursor 编辑器中自定义光标行为规则（比如中文环境下按 Ctrl+左右箭头跳过整个词），但找不到 Rules 文件该放哪、怎么命名、是否需要手动创建——这些细节直接影响配置能否生效。
Rules 文件的存放位置
Cursor 的 Rules 配置文件必须放在项目根目录下的 【.cursor/rules.json】 路径，且文件名必须严格为 rules.json（全小写，无空格，无其他后缀）。
如果项目根目录下没有 .cursor 文件夹，需手动新建；若已有，则直接放入该文件夹内。Cursor 启动时会自动扫描此路径，其他位置（如用户主目录、VS Code 设置目录、或顶层 workspace 文件夹外）的 rules.json 均不会被识别。
Rules 文件的内容格式与验证
打开 .cursor/rules.json，输入合法 JSON 格式内容，例如：
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
{"rules": [{"id": "chinese-word-jump", "description": "中文词级跳转", "pattern": ".*", "actions": [{"type": "setWordSeparators", "separators": ["\u4e00-\u9fa5", "\s", "\p{P}"]}]}
注意：JSON 必须语法正确，且最外层必须是对象，【"rules" 字段不可省略，且值必须为数组】。少一个方括号或引号不闭合，Cursor 就会静默忽略整个文件，不报错也不生效。
启用 Rules 的关键操作
第一步：确保当前编辑器窗口已打开一个真实项目文件夹（而非单个文件或空窗口）→ 第二步：确认 .cursor/rules.json 已保存 → 第三步：按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板 → 输入并选择 Cursor: Reload Rules。
这一步不可跳过。修改 rules.json 后，Cursor 不会自动热重载；必须手动触发重载，否则所有新规则都处于“写好了但没生效”状态。重载成功后，状态栏右下角会出现短暂提示「Rules reloaded」。
