先查有没有可用的formatter：VSCode不自带语言级格式化能力，Shift+Alt+F（Win/Linux）或Cmd+Shift+I（macOS）无响应，主因是未安装对应语言的格式化扩展或未设置默认格式化器；可通过Ctrl+Shift+P输入“Format Document With...”查看列表是否为空来确认。
格式化快捷键没反应，先查有没有可用的 formatter
VSCode 本身不带语言级格式化能力，Shift+Alt+F（Windows/Linux）或 Cmd+Shift+I（macOS）按下去没反应，大概率是缺扩展或没设默认。打开命令面板 Ctrl+Shift+P，输入 Format Document With...，看下拉列表里有没有选项。如果只有 Configure Default Formatter...，说明当前语言没装 formatter。
常见对应关系：
- JavaScript/TypeScript：
esbenp.prettier-vscode（需安装插件，且项目有.prettierrc或package.json中含prettier字段） - Python：
ms-python.python（配合black或autopep8，本地得装pip install black） - CSS/HTML：
esbenp.prettier-vscode或启用内置css.format.enable
语法检查器（如 ESLint）不报错，重点查 language server 和配置文件
ESLint 提示消失、错误不标红、Fix all auto-fixable problems 灰掉——不是插件没装，而是 language server 没起来，或配置被覆盖。先确认右下角语言模式是否正确（比如 .js 文件显示的是 JavaScript，不是 Plain Text）。
再检查三处：
-
settings.json里是否有"eslint.enable": true，且没被工作区设置覆盖 - 项目根目录是否存在
.eslintrc.js/.eslintrc.json，内容是否合法（JSON 不允许//注释、尾逗号） - 终端执行
npx eslint --version，确认本地eslint已安装（插件依赖它启动 server）
输出面板（Ctrl+Shift+U）切到 ESLint 标签，常能看到具体报错，比如 "Cannot find module 'eslint-plugin-react'" —— 这说明插件依赖缺失，不是 VSCode 配置问题。
重置校验状态：别删插件，先 reload + reset storage
ESLint/Prettier 突然失效，但配置和插件都对，很可能是 UI 缓存或 language server 状态卡死。此时不用动 settings.json，直接组合操作：
- 按
Ctrl+Shift+P→ 执行Developer: Reload Window（重载窗口，重启所有服务） - 再执行
ESLint: Restart ESLint Server（如有该命令）或Prettier: Restart Prettier Server - 若面板位置错乱、折叠状态异常，补一个
View: Reset View Locations（只重置 UI 布局，不影响配置）
这个流程能解决 70% 的“明明装了却不动”问题，比删配置快，也不丢快捷键和片段。
User 目录损坏时，必须关 Sync 再重命名
如果上述都试过，ESLint 输出面板持续报 "Failed to load config 'xxx'..."，且 keybindings.json 也乱（比如 Ctrl+S 突然变保存为…），说明 User 目录整体写崩了。这时候清空 settings.json 不够，因为 storage.json（存插件状态）、globalStorage/（插件私有数据）可能已损坏。
- 先关 Settings Sync：
Ctrl+Shift+P→Preferences: Turn Off Settings Sync→ 勾选Turn Off and Reset Local State - 彻底退出 VSCode：macOS 查「活动监视器」杀光
Code Helper，Windows 用任务管理器确认无Code.exe进程 - 重命名 User 目录：
— Windows：%APPDATA%\Code\User\→ 改为User_backup
— macOS：~/Library/Application Support/Code/User/→ 改为User_backup
— Linux：~/.config/Code/User/→ 改为User_backup
重启后 VSCode 会新建干净 User 目录，但注意：已登录账户、自定义快捷键、代码片段、折叠状态全丢——这是预期行为，不是 bug。
真正容易被忽略的点是 Settings Sync：只要它开着，哪怕你重命名了 User 目录，一启动就会从云端拉回旧配置，包括你半年前随手加的冲突 files.associations。关 Sync 必须在重命名前完成，且勾选 Reset Local State。
