如何配置VS Code编辑STM32项目并消除错误波浪线

以下是基于Cube IDE工具链配置VS Code的具体步骤，能彻底解决头文件找不到、定义无法跳转以及错误波浪线的问题：

1. 配置C/C++扩展核心参数 #

打开VS Code，按下Ctrl+Shift+P（Mac为Cmd+Shift+P），输入C/C++: Edit Configurations (JSON)，打开c_cpp_properties.json后按规则修改：

• 指定编译器路径：将compilerPath指向Cube IDE自带的ARM GCC编译器，路径示例：

  • Windows："compilerPath": "C:/ST/STM32CubeIDE_1.13.0/STM32CubeIDE/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.win32_1.1.0.202309131626/tools/bin/arm-none-eabi-gcc.exe"
  • Linux："compilerPath": "/opt/st/stm32cubeide_1.13.0/stm32cubeide/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.linux64_1.1.0.202309131626/tools/bin/arm-none-eabi-gcc"
  • macOS："compilerPath": "/Applications/STMicroelectronics/STM32CubeIDE_1.13.0/STM32CubeIDE.app/Contents/Eclipse/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.macosx_1.1.0.202309131626/tools/bin/arm-none-eabi-gcc"

• 添加头文件路径：在includePath中加入项目及工具链的所有头文件目录（替换为你的实际路径）：

  "includePath": [
    "${workspaceFolder}/**",
    "${workspaceFolder}/Core/Inc",
    "${workspaceFolder}/Drivers/STM32F4xx_HAL_Driver/Inc",
    "${workspaceFolder}/Drivers/STM32F4xx_HAL_Driver/Inc/Legacy",
    "${workspaceFolder}/Drivers/CMSIS/Include",
    "${workspaceFolder}/Drivers/CMSIS/Device/ST/STM32F4xx/Include",
    // 工具链标准库路径，对应编译器目录的上级include文件夹
    "C:/ST/STM32CubeIDE_1.13.0/STM32CubeIDE/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.win32_1.1.0.202309131626/tools/arm-none-eabi/include",
    "C:/ST/STM32CubeIDE_1.13.0/STM32CubeIDE/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.win32_1.1.0.202309131626/tools/arm-none-eabi/include/c++/11.3.1"
  ]
  

• 添加编译宏定义：在defines中加入项目对应的芯片宏和HAL宏，比如：

  "defines": [
    "STM32F407xx",
    "USE_HAL_DRIVER"
  ]
  

2. 利用Cube IDE生成的compile_commands.json（推荐） #

如果已用Cube IDE构建过项目，可自动生成编译参数文件：

1. 在Cube IDE中右键项目 → Properties → C/C++ Build → Settings → Tool Settings → GCC C Compiler → Miscellaneous，在Other flags里添加-save-temps=obj -g
2. 重新构建项目，根目录会生成compile_commands.json
3. 在VS Code的c_cpp_properties.json中添加：

   "compileCommands": "${workspaceFolder}/compile_commands.json"
   

   此方式无需手动配置路径和宏，VS Code会自动读取所有编译参数，是最省心的方案。

3. 优化STM32-for-vscode扩展配置 #

打开VS Code设置（Ctrl+,），搜索stm32-for-vscode，设置两个核心参数：

• STM32CubeIDEPath：指向Cube IDE安装根目录，比如C:/ST/STM32CubeIDE_1.13.0/STM32CubeIDE
• toolchainPath：指向Cube IDE自带ARM GCC工具链的bin目录，即上述compilerPath所在的bin文件夹路径

完成配置后重启VS Code，错误波浪线会消失，头文件和定义可正常跳转。

内容的提问来源于stack exchange，提问作者Cats