VS Code格式化文档打乱#include顺序的问题求助

我来帮你搞定这个问题！在MacOS上使用VS Code搭配PlatformIO时，格式化工具自动调整#include顺序导致编译错误，本质是默认启用了clang-format的头文件排序功能。要只保留代码格式化、禁止调整头文件顺序，你可以按照以下步骤操作：

1. 创建/修改项目的clang-format配置文件 #

PlatformIO会优先读取项目根目录（和platformio.ini同级）的.clang-format配置文件来控制格式化规则。如果你的项目还没有这个文件，直接在根目录新建一个；如果已经存在，直接编辑即可。

2. 添加关键配置项禁用头文件排序 #

在.clang-format中添加或修改以下核心配置，确保关闭头文件排序功能，同时保留正常的代码格式化：

Language: Cpp
# 核心配置：关闭头文件自动排序
SortIncludes: false

# 以下是可选的基础格式化配置，可根据个人习惯调整
IndentWidth: 4
UseTab: Never
TabWidth: 4
BreakBeforeBraces: Attach
AllowShortIfStatementsOnASingleLine: false
ColumnLimit: 120

其中SortIncludes: false是解决问题的关键，它会让格式化工具完全保留你手动编写的#include顺序，不再自动排序。

3. 让配置生效 #

保存.clang-format文件后，通过以下方式让VS Code加载新配置：

• 按下Cmd+Shift+P打开命令面板，选择Reload Window重新加载窗口；
• 或者直接重启VS Code。

之后再使用STRG-ALT-F（Mac上对应快捷键是Cmd+Option+F）格式化代码时，就只会调整代码的缩进、换行等格式，而不会改动#include的顺序了，编译错误也会随之消失。

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