根本原因是系统自带clang的-v输出不含标准头路径，导致qt creator解析失败；正确做法是用homebrew安装llvm并填入/opt/homebrew/opt/llvm/bin/clang（apple silicon）或/usr/local/opt/llvm/bin/clang（intel），且c/c++编译器版本必须一致。
Clang编译器路径填错导致“Project ERROR: failed to parse default search paths”
这是Mac上最常触发的报错，根本原因不是Qt版本或项目配置问题，而是Qt Creator调用clang时无法解析其内置头文件路径。系统自带的Clang（来自Xcode Command Line Tools）输出格式和Qt期望的不一致，尤其在Apple Silicon Mac上更明显。
-
/usr/bin/clang和/usr/bin/clang++不能直接填进“C编译器”和“C++编译器”字段——Qt Creator会尝试运行clang -E -x c++ - -v来提取系统头路径，但Apple Clang的-v输出不含标准include路径行，导致解析失败 - 正确做法是使用Homebrew安装的LLVM：先运行
brew install llvm，然后在编译器设置中填入/opt/homebrew/opt/llvm/bin/clang（Intel Mac为/usr/local/opt/llvm/bin/clang） - 务必同时指定C++编译器为
/opt/homebrew/opt/llvm/bin/clang++，且两者版本号必须一致（检查clang --version和clang++ --version输出末尾的LLVM版本号）
Kit里选了Clang却还是用GCC或MSVC编译
Qt Creator的Kit（构建套件）是编译器、Qt版本、调试器三者的绑定组合，光在“编译器”页添加了Clang，不代表项目就会用它——必须显式关联到Kit，且该Kit被项目选中。
- 进入
Preferences → Kits，点击右侧“Add”新建Kit，名称建议带版本标识，如Desktop Qt 6.5.3 Clang 18.1 - 在“Compiler”下拉框中，分别选择你刚添加的Clang C和C++编译器（注意：不是“Auto-detected”，必须手动点选）
- “Qt version”必须指向一个与Clang ABI兼容的Qt构建，Homebrew装的
qt默认用Clang构建，但qt@5可能用GCC；若不确定，运行qmake -query QT_VERSION再查对应构建日志 - 项目打开后，在左侧“Projects”面板的“Build & Run”页，确认“Kit”下拉框选中的是你刚建的那个Clang Kit，而不是灰色显示的“Auto-detected”项
Clang编译通过但链接失败：undefined symbol _ZdlPvm
这说明C++标准库链接不匹配，典型症状是编译无报错、ld阶段失败，错误里混着mangled name（如_ZdlPvm是operator delete(void*, unsigned long)）。根源在于Clang前端调用的libc++和Qt链接时找的libstdc++冲突。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- Homebrew安装的Qt（
brew install qt）默认链接libc++，所以你的Clang Kit必须也用libc++——检查clang++ --print-supported-libraries输出是否含libc++ - 避免混用：不要把系统GCC的
libstdc++路径（如/usr/lib/gcc/.../libstdc++.dylib）加进Kit的“C++ Standard Library”设置；应留空或明确选libc++ - 如果项目用了第三方静态库（如OpenSSL），确认它也是用
libc++编译的；否则需重新用clang++ -stdlib=libc++编译该库
Clang-format路径填对了但代码格式化没反应
Clang-format插件依赖两个独立配置：一是可执行文件路径，二是项目级或全局的.style文件。路径正确只是第一步，格式化行为还受Qt Creator内部规则压制。
- 路径必须指向真实可执行文件，例如
/opt/homebrew/opt/llvm/bin/clang-format，不能是符号链接（某些Homebrew版本的clang-format是link，需用readlink -f展开） - 在
Preferences → Beautifier → Clang Format中，“Use predefined style”必须关掉，否则自定义配置无效；“Configuration file”建议设为.clang-format（项目根目录），而非“File in home directory” - 关键隐藏开关：在同一个页面，“Clang Format”下方有个“Only format selected text”复选框，如果勾选了，全文件格式化（Ctrl+I）会静默失败——取消勾选才能生效
Clang配置真正的难点不在路径填写，而在于ABI一致性：从编译器、标准库、Qt构建、第三方库到格式化工具链，所有环节必须统一libc++且版本对齐。任何一环脱节，都会表现为看似随机的链接失败或运行时崩溃。
