clang-format在vscode中默认不生效，需手动配置：指定xaver.clang-format为[c]/[cpp]默认格式化器、.clang-format文件置于工作区根目录且utf-8+lf编码、clang-format可执行文件在path中或显式配置路径，并确保.h文件被识别为c/c++。
VSCode 插件安装本身不难，但真正卡住人的往往是「装完没反应」「格式化不生效」「插件找不到可执行文件」——这些问题基本都出在路径、配置覆盖关系或权限上。
扩展面板打不开或搜索无响应
先确认 VSCode 已完全启动，不是刚解压还没初始化的状态。如果点击拼图图标没反应，试试快捷键 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）。偶尔因网络问题导致 Marketplace 加载失败，可临时切换到离线模式再重试：在命令面板（Ctrl+Shift+P）中运行 Developer: Toggle Developer Tools，看 Console 是否报 ERR_CONNECTION_REFUSED 或 network error。此时可改用命令行安装，绕过 UI 网络请求。
手动安装 .vsix 插件失败：command not found 或 Permission denied
code --install-extension 命令失效，大概率是 code 没加进系统 PATH。Linux/macOS 下执行 which code，若为空，说明 VSCode 没注册 shell 命令——打开 VSCode，按 Ctrl+Shift+P，输入 Shell Command: Install 'code' command in PATH 并运行。Windows 用户需确认是否勾选了「Add to PATH」安装选项，否则得手动把 Code.exe 所在目录（如 C:UsersXXXAppDataLocalProgramsMicrosoft VS Codein）加进环境变量。
出现 Permission denied 时，不是插件问题，而是 .vsix 文件权限不足：chmod 644 your-extension.vsix 再重试。
clang-format / Prettier 类插件不自动格式化
这类插件依赖两个关键配置同时生效：editor.defaultFormatter 和 editor.formatOnSave。缺一不可。比如用了 xaver.clang-format，必须设 "editor.defaultFormatter": "xaver.clang-format"；用了 esbenp.prettier-vscode，就得对应写 "editor.defaultFormatter": "esbenp.prettier-vscode"。
-
"clang-format.style": "file"表示去当前项目找.clang-format，但实际会按顺序查：当前文件所在目录 → 工作区根目录 → 用户主目录 → fallbackStyle -
"clang-format.assumeFilename"如果硬编码了绝对路径（如"/home/user/.clang-format"），就跳过查找逻辑，直接读那个文件——但要注意该路径是否存在、是否有读权限 - 多个配置层级（用户 settings.json / 工作区 settings.json / .code-workspace）之间有覆盖规则：工作区 > 用户，别在用户级配了全局路径，又在项目里留空，结果根本没加载到项目级配置
插件配置后仍提示“找不到 clang-format 可执行文件”
错误信息通常是 Cannot find executable 'clang-format' 或 spawn clang-format ENOENT。这不是插件问题，而是路径没对上。
先在终端里跑 which clang-format（Linux/macOS）或 where clang-format（Windows），拿到真实路径。然后填进 clang-format.executable 配置项——注意不能只写 "clang-format"，必须是完整路径，比如 "/usr/bin/clang-format" 或 "C:\Program Files\LLVM\bin\clang-format.exe"。
如果用的是 conda 环境里的 clang-format，路径可能是 "~/miniconda3/envs/myenv/bin/clang-format"，记得展开 ~ 成绝对路径，或者用 $HOME（Linux/macOS）或 %USERPROFILE%（Windows）。
最常被忽略的点：插件配置写在了错误的 settings.json 里——用户级配置在 ~/.config/Code/User/settings.json（Linux）、~/Library/Application Support/Code/User/settings.json（macOS）、%APPDATA%CodeUsersettings.json（Windows）；而工作区配置在项目根目录下的 .vscode/settings.json。两者内容不互通，改错地方等于没改。
