Cursor 编辑器 CLI 速查表 - 新窗口 -n 与 Agent 参数
Cursor 是基于 VS Code 的 AI 编辑器，其 CLI 与 cursor-agent 面向习惯在终端里快速打开项目、管理窗口与扩展、并希望把编辑器和 AI 能力写进脚本的开发者。与普通编辑器命令行不同，Cursor 的差异点是编辑器内 AI 编码与可无头调用的 cursor-agent；本表帮你掌握从命令行打开/对比文件，到 Agent 自动化与 git 编辑器集成的常用命令。
打开文件与目录 6
cursor .cursor /path/to/file.tscursor /path/to/file.ts:42cursor /path/to/file.ts:42:10cursor /path/to/projectcursor file1.ts file2.ts file3.ts窗口管理 6
cursor -n /path/to/projectcursor -r /path/to/filecursor -w /path/to/filecursor --mergecursor --add /path/to/foldercursor --locale zh-TW对比与合并 2
cursor -d file1.ts file2.tscursor -m base.ts mine.ts theirs.ts out.ts扩展管理 4
cursor --list-extensionscursor --install-extension esbenp.prettier-vscodecursor --uninstall-extension <id>cursor --disable-extensions渲染与性能 7
cursor --disable-gpucursor --disable-hardware-accelerationcursor --user-data-dir /path/to/datacursor --extensions-dir /path/to/extcursor --max-memory 4096cursor --verbose /path/to/filecursor --status远程开发 5
cursor --remote ssh-remote+hostcursor --folder-uri vscode-remote://ssh-remote+host/pathcursor --file-uri vscode-remote://.../file.tscursor --proxy-server http://proxy:8080cursor --no-proxy-server调试与诊断 5
cursor --inspectcursor --inspect-brkcursor --log errorcursor --log-file /tmp/cursor.logcursor --enable-proposed-apiCursor Agent 与 git 集成 3
cursor-agent -p "你的提问" --mode=ask --output-format textgit config --global core.editor "cursor --wait"cursor --goto file.py:128提示
- 终端快开项目：
cursor .比鼠标点开快得多；对比改动用cursor -d a.ts b.ts直接出 diff 视图。 - 把 Cursor 设为 git 编辑器（
core.editor "cursor --wait"），提交时自动弹出带行号的编辑器，写完关闭即继续。 - CI/脚本里用
--wait配合 diff 或编辑器调用，命令会阻塞到窗口关闭，便于串联流程。 - Cursor Agent 可用
cursor-agent -p非交互调用，适合在流水线里做 ask/code 类自动任务。
常见问题
怎么把 Cursor 当作 git 的提交信息编辑器？
执行 git config --global core.editor "cursor --wait"。--wait 让 git 启动 Cursor 后等待你保存并关闭窗口再继续，这样提交信息就能在编辑器里写。类似地也可以设 core.diffeditor 用于查看 diff。这是把编辑器接进 git 工作流最省事的一招。
cursor -w 什么时候必须加？
-w/--wait 会让命令等待窗口关闭后再返回。凡是后续步骤依赖你在编辑器里完成的事情就要加它，比如 git 提交信息、git rebase -i 编辑 todo 列表、或者某些需要你在 GUI 里点确认的工具。普通打开文件则不需要加，否则命令行会一直卡着。
cursor-agent 的 ask 和 code 模式有什么区别？
ask 模式只回答问题、不改动任何文件，适合让 Agent 分析代码或给方案；code 模式会实际读写文件并执行命令。命令行调用示例：cursor-agent -p "你的提问" --mode=ask --output-format text。加 --output-format text 得到纯文本结果，便于脚本捕获。
Cursor 启动变慢或内存占用高怎么办？
先用 --disable-extensions 排查是不是扩展拖慢的，用 --max-memory 4096 限制内存。大型 monorepo 可以用 --disable-gpu 或 --disable-hardware-acceleration 排除渲染开销。还要留意你打开了多少工作区，--user-data-dir 和 --extensions-dir 可以隔离测试环境而不影响日常配置。
怎么打开远程服务器上的项目？
cursor --remote ssh-remote+host 连接配置好的 SSH 远程并在其中打开工作区，前提是 SSH 配置里已有该主机。也可以用 --folder-uri vscode-remote://ssh-remote+host/path 直接指定远程目录，或 --file-uri vscode-remote://.../file.ts 打开远程上的单个文件。走不通时先确认 ssh host 能正常连接。
由 巧匠 维护
公开更新于 2026年8月5日，内容持续校对官方文档。