VSCode代码格式化失效通常因工具未安装、未正确配置或被干扰项屏蔽。需依次确认：格式化扩展已启用并本地安装；settings.json中开启formatOnSave、指定defaultFormatter；语言模式识别正确；排除Beautify等冲突扩展及配置文件错误。
VSCode代码格式化不起作用，通常不是“坏了”，而是某个环节没对上。核心就三点：有没有装对工具、有没有告诉VSCode用它、有没有被别的设置拦住。下面按真实排查顺序讲清楚。
确认格式化工具已安装并启用
VSCode自己不格式化代码，得靠扩展。比如写JS/TS要用Prettier，写Python要用Black，写C++要用clang-format。
- 打开扩展面板（Ctrl+Shift+X），搜“Prettier - Code formatter”，确认状态是已启用；如果是Vue项目，Vetur或Volar也得开着
- 别只装用户级插件——建议在项目里本地安装：
npm install --save-dev prettier，这样VSCode会优先用项目里的版本，避免全局版本不兼容 - XML、Go、Rust等语言同理：查对应扩展是否启用，比如Red Hat XML、Go Nightly、rust-analyzer
检查关键配置是否生效
光有插件不够，还得明确告诉VSCode“保存时请调我”。这些配置必须写对、写准、没被覆盖。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
-
必须开启自动保存格式化：
"editor.formatOnSave": true -
必须指定默认格式化程序，例如：
"editor.defaultFormatter": "esbenp.prettier-vscode"（注意ID别拼错） - 推荐加上
"editor.formatOnSaveMode": "modifications"，避免全文件重排引发大量diff - 配置位置有优先级：工作区（
.vscode/settings.json） > 用户设置 > 默认设置。优先在项目里配，团队更一致
验证语言模式与文件关联是否正确
VSCode按“语言模式”决定调哪个格式化器。如果.js文件被识别成“Plain Text”，Prettier根本不会启动。
- 看右下角状态栏，确认当前文件的语言模式（如JavaScript、TypeScript、Vue等）。点它可手动切换
- 若不对，加这条到
settings.json："files.associations": { "*.vue": "vue" } - 某些后缀需显式绑定，比如
".env": "shellscript"或".jsonc": "json" - 快捷键
Shift+Alt+F没反应？先试试右键菜单“格式化文档”是否灰掉——灰了说明VSCode压根没识别出语言
排除常见干扰项
有时候格式化“看起来失效”，其实是被其他设置静默屏蔽了。
- 禁用冲突扩展：Beautify、ESLint（未配置协同时）、Auto Rename Tag等可能抢格式化入口。临时全禁用，只留Prettier测试
-
检查
prettier.requireConfig：设为false可让Prettier无配置文件也能运行；若设为true但项目缺.prettierrc，它就会沉默退出 - 留意项目级配置文件：.prettierrc、.editorconfig、.eslintrc.js存在语法错误，会导致Prettier加载失败（无报错，只不干活）
- Mac用户用Settings Sync同步后失效？很可能是Vetur/Prettier插件状态没同步，重装一次常能解决
基本上就这些。从插件→配置→语言识别→干扰项，一层层过，90%的格式化失效都能当场定位。不复杂，但容易忽略某一个细节。
