VSCode本身不自带代码格式化能力，必须依赖插件与外部工具协同：Prettier需安装esbenp官方插件并配置语言绑定及formatOnSave；clang-format需单独下载clang-format.exe（非完整LLVM），配置executable路径并关联c/cpp语言；SQL需专用插件SQL Beautify且手动确认语言模式。
VSCode 本身不自带代码格式化能力，必须靠插件 + 外部工具协同工作；直接装插件却没配好底层可执行文件，Alt+Shift+F 按下去大概率没反应，或者报错 Failed to format document. Cannot find module 'clang-format' 这类提示。
怎么下载 Prettier（JavaScript/TypeScript/HTML/CSS 等通用场景）
Prettier 是最常用、开箱即用程度最高的格式化插件，适合前端和全栈项目：
- 打开 VSCode 扩展面板（
Ctrl+Shift+X），搜Prettier - Code formatter，认准发布者是esbenp - 安装后，必须在
settings.json中指定语言绑定，否则保存时不会触发：{ "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } } - 启用自动保存格式化：
"editor.formatOnSave": true，但注意：如果项目根目录有.prettierrc或prettier.config.js，Prettier 会优先读取它；没配置文件时才走插件默认规则 - 常见坑：
prettier.requireConfig设为true却没放配置文件，会导致保存时静默失败——这个开关默认是false，别乱开
怎么下载 clang-format（C/C++ 专用，Windows 下最容易踩坑）
clang-format 不是 VSCode 插件，而是命令行工具；VSCode 的 xaver.clang-format 插件只是个“壳”，必须手动装好 clang-format.exe 并告诉它在哪：
- 别下完整 LLVM（2GB+），直接去 GitHub 下精简版：找
clang+llvm-18.1.8-x86_64-pc-windows-msvc这类命名的压缩包，解压后取binclang-format.exe - 把该路径加进系统
PATH环境变量，然后在 CMD 里运行clang-format --version验证是否识别 - 在
settings.json中硬编码路径（避免 PATH 变更导致失效）："clang-format.executable": "C:\Users\你的用户名\AppData\Local\Programs\clang+llvm-18.1.8-x86_64-pc-windows-msvc\bin\clang-format.exe" - 必须配语言关联：
"[c]": { "editor.defaultFormatter": "xaver.clang-format" }和"[cpp]": { "editor.defaultFormatter": "xaver.clang-format" } - 项目根目录要放
.clang-format文件，否则按默认风格格式化——clang-format --style=file --dump-config可生成当前生效的完整配置供参考
SQL 格式化插件（Hive/Spark SQL 等数据开发场景）
别用通用插件处理 SQL，关键词大小写、字段换行、嵌套子查询缩进等逻辑完全不同：
- 搜
SQL Beautify（发布者clarkyu2016），安装即用，无需额外二进制依赖 - 关键前提：文件语言模式必须是
SQL（右下角状态栏确认，不是plaintext或text）；如果是.hql或.sql文件但识别错了，点一下状态栏手动切过去 - 它不支持
editor.formatOnSave，只能手动选中代码段后按Alt+Shift+F；全文件格式化前建议先备份，某些复杂 CASE WHEN 或注释位置可能被误调整 - 没有项目级配置文件机制，所有规则内置，无法自定义缩进宽度或关键字大写策略
真正麻烦的从来不是“怎么装”，而是“装完谁管谁”：Prettier 管格式、ESLint 管逻辑、clang-format 管 C++ 细节、SQL Beautify 只管 SQL 表面——它们之间没协调机制。一个文件同时被多个插件声明为默认格式器时，VSCode 只听最后一个生效的。所以 settings.json 里每条 "[language]" 规则都得亲手核对，漏一条，那种语言就彻底“裸奔”。
