一、安装与环境建议
1. 插件与兼容性
Cursor 基于 VS Code 1.85+，部分旧插件可能不兼容。 推荐安装以下插件：
| 插件名称 | 作用 |
|---|---|
| C/C++ Extension Pack | 提供语法补全与调试支持 |
| Remote - SSH | 远程开发 |
| CodeLLDB | C/C++ 调试 |
| Better C++ Syntax | 增强语法高亮 |
| GitLens | 代码版本追踪 |
如果提示 'not compatible'，可以手动安装：
或下载
.vsix文件手动导入。
2. 远程开发配置
建议使用 Remote SSH 模式，在远程服务器上直接编译与调试。
在本地 .cursor/settings.json 中添加配置：
{
"remote.SSH.remotePlatform": {
"your_server": "linux"
},
"C_Cpp.intelliSenseEngine": "Default",
"C_Cpp.loggingLevel": "Error"
}
二、AI 辅助操作速查表
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 打开 AI 聊天 | Ctrl + K / ⌘ + K | 与 AI 对话 |
| 内联编辑 | Ctrl + I / ⌘ + I | 在选中代码上调用 AI |
| 解释代码 | Ctrl + L 或右键 → 'Ask Cursor' | 让 AI 解读函数或逻辑 |
| 生成注释 | Ctrl + Shift + I | 自动补充函数注释 |
| 跳转定义 | F12 | 与 VS Code 一样 |
💡 提示：
如果 F12 跳转无效，请在工程中生成 compile_commands.json：
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .
然后在配置中指定路径：
{
"C_Cpp.default.compileCommands": "/path/to/compile_commands.json"
}
三、常用 AI 工作流示例
1. 阅读与理解老代码
选中函数，按下 Ctrl + I 输入：
解释这个函数的作用和逻辑流程
AI 会自动生成注释说明和调用关系，特别适合阅读 FreeSWITCH 或 Sofia 栈中的复杂逻辑。
2. 分析崩溃或 ASan 报告
选中堆栈或日志，输入：
帮我分析这个崩溃堆栈的原因
Cursor 会结合上下文解释崩溃位置及可疑指针操作。
3. 优化性能或代码结构
选中循环或内存操作片段，输入：
请优化这段代码的性能，并保持逻辑一致
它能自动改写为更简洁、高效的实现。
4. 自动生成头文件或声明
输入：
为当前源文件生成对应的 .h 文件
AI 会提取函数声明并生成符合规范的头文件。
四、性能优化与稳定性
| 问题 | 解决办法 |
|---|---|
| 工程大导致卡顿 | "C_Cpp.intelliSenseEngine": "Tag Parser" |
| AI 回复慢 | 使用轻量模型：Ctrl + Shift + P → Cursor: Select AI Model |
| 聊天窗口卡死 | Ctrl + Shift + P → Developer: Reload Window |
五、隐私与本地模式
Cursor 默认会将上下文发往云端模型处理。 若想仅本地使用部分功能，可启用本地模式：
{
"cursor.experimental.localMode": true
}
六、适合 C/C++ 开发的典型场景
| 场景 | 推荐用法 |
|---|---|
| 阅读 FreeSWITCH 栈函数 | Explain this function |
| 优化底层模块 | Optimize for speed and clarity |
| ASan 崩溃排查 | Analyze ASan report |
| 模块移植（OpenSIPS/Kamailio） | Compare behavior between A and B |
| 写博客/文档 | Generate Markdown explanation with comments |
七、Cursor 推荐配置模板
可在 .cursor/settings.json 中使用以下模板：
{
"C_Cpp.default.compileCommands": "${workspaceFolder}/build/compile_commands.json",
"C_Cpp.intelliSenseEngine": "Default",
"cursor.experimental.localMode": false,
"editor.formatOnSave": true,
"files.exclude": {
"**.git": true,
"**/build": true
},
"editor.minimap.enabled": false
}
总结
Cursor 不只是一个 AI 编辑器，它是 VS Code 的'强化版助手'。 在底层开发中，它能：
- 快速解释复杂 C 逻辑；
- 自动生成注释与声明；
- 辅助调试 ASan 报告；
- 帮助优化内存与性能问题。
