Cursor 环境及工程搭建

2026-08-06

摘要

Cursor是一个基于AI的代码编辑器，它可以帮助你快速生成代码，提高开发效率。
2025年上班年时与VSCode整体差别不大，随着Cursor的更新，部分功能对比VSCode有些许不同。
最终效果相同项目在Cursor和VSCode中均能正常运行。

环境搭建

gcc、make、cmake、openocd 与环境搭建 VSCode一致

安装Cursor

下载地址：CursorSetup-1.124.0.exe
直接默认安装即可，安装中选项选择Add to PATH，这样就不需要手动添加环境变量。

Cursor登录

这里与VSCode不同，需要登录才可使用，也可以使用github、google、apple、microsoft账号登录。
没有账号可以注册一个。
注册后会自动登录，并跳转到主界面 Cursor Agents。
跳转IDE: 主界面 Cursor Agents 左侧栏点击 Cursor IDE 即可跳转IDE。
直接打开IDE: 启动时添加参数 --classic 即可直接打开IDE。

安装插件

与环境搭建 VSCode一致，这里不再赘述。

安装clangd

vscode 采用 c_cpp_properties.json 文件来获取项目信息， cursor 采用 compile_commands.json 文件来获取项目信息。正常情况下clangd会自动下载clangd-windows-22.1.6.zip自动安装。如果自动下载失败，可参考以下内容手动安装。

下载地址：clangd-windows-22.1.6.zip
解压到C:\Program Files\clangd-22.1.6目录下。
将C:\Program Files\clangd-22.1.6目录下的clangd.exe文件添加到系统环境变量Path中。
- win + e打开文件资源管理器，右键此电脑，选择属性
- 点击高级系统设置，点击环境变量
- 在系统变量中找到Path，点击编辑，点击新建，输入C:\Program Files\clangd-22.1.6，点击确定保存
完成后切回桌面输入win + r，输入cmd打开命令行，输入clangd --version查看是否安装成功。

C:\Users\user>clangd --version
clangd version 22.1.6 (https://github.com/llvm/llvm-project fc4aad7b5db3fff421df9a9637605b9ca5667881)
Features: windows+grpc
Platform: x86_64-pc-windows-msvc

C:\Users\user>

快捷键

Cursor 默认构建任务快捷键为Ctrl + Shift + B，但是打开和Open browser 相同，将该快捷键改为其他后，点击Ctrl + Shift + B即可打开构建任务。

Ctrl + Shift + P, 打开命令面板输入 打开键盘快捷键方式
搜索 open browser ，点击编辑，将其改为ctrl+capslock ctrl+b 或其他快捷键即可

工程搭建

与工程搭建 VSCode大同小异。

compile_commands.json

cursor 采用 compile_commands.json 文件来获取项目信息。

修改CMake工程根 project/CMakeLists.txt文件，添加如下内容，已自动生成compile_commands.json文件。

# 设置 CMake 最低支持版本
cmake_minimum_required(VERSION 3.17)

# 导出编译命令
set(CMAKE_EXPORT_COMPILE_COMMANDS ON) 

# Cmake 交叉编译配置
set(CMAKE_SYSTEM_NAME Generic)

添加配置文件，告知compile_commands.json文件路径

project# 工程根目录

stlink-dap.cfg# 仿真器配置文件

stm32f1x.cfg# 目标芯片配置文件

STM32F103xx_FLASH.ld# 链接脚本文件

STM32F103xx.svd# 目标芯片寄存器

stm32f10x_conf.h# 标准外设库配置文件

CMSIS# 架构库目录

STM32F10x_StdPeriph_Driver# 标准外设库目录

build# 空目录、编译镜像输出

.vscode# vscode配置目录

c_cpp_properties.json# C/C++配置文件

tasks.json# 任务配置文件

launch.json# 调试仿真配置文件

settings.json# 设置配置文件

main.c# LED点亮示例代码

CMakeLists.txt# CMAKE编译配置文件

.vscode/settings.json
{
    "C_Cpp.default.compileCommands": "${workspaceFolder}/build/compile_commands.json",
    "C_Cpp.default.intelliSenseMode": "gcc-arm",
    "C_Cpp.default.cStandard": "c99",
    "C_Cpp.default.cppStandard": "c++11"
}

关闭内联提示

Cursor 默认会自动弹出内联提示，可以在设置中关闭。

Ctrl + Shift + P, 打开命令面板输入 打开设置
搜索 inline hints ，点击编辑，将其改为offUnlessPressed, ctrl + alt 触发提示。