Ctrl+Shift+P不能直接运行ESLint修复命令，因插件默认不暴露eslint --fix到命令面板，且需满足文件类型匹配（js/ts）、ESLint配置加载成功、编辑器启用codeActionsOnSave等前提；快捷键需绑定editor.action.codeAction并限定source为eslint。
为什么 Ctrl+Shift+P 不能直接运行 ESLint？
很多人以为装了 ESLint 插件就能一键检查，结果按 Ctrl+Shift+P 搜 “ESLint Fix” 却找不到——因为默认不绑定快捷键，插件也分“只报告”和“自动修复”两类。ESLint 本身是 CLI 工具，VSCode 插件只是桥接层，它不会自动把所有命令暴露到命令面板，尤其 eslint --fix 这类写操作，默认被限制为仅在保存时触发。
- 必须手动启用
"eslint.autoFixOnSave": true（已废弃）或改用"editor.codeActionsOnSave"新配置 -
Ctrl+Shift+P搜不到命令，大概率是插件没激活（比如当前文件没匹配.eslintrc.*或无package.json中的devDependencies） - JS/TS 文件类型识别错误也会导致命令不可见——检查右下角状态栏语言模式是否为
javascript或typescript，不是plaintext
如何给 eslint --fix 绑定真正可用的快捷键？
VSCode 不允许直接绑定 CLI 命令，但可通过“代码操作”（Code Action）间接触发。关键不是找 ESLint 命令，而是绑定编辑器原生的 editor.action.codeAction，并限定作用域为 ESLint 修复。
- 打开设置 → 搜索
keyboard shortcuts→ 点左上角“打开键盘快捷方式（json）”图标 - 添加如下条目（注意：必须用
source指定提供者，否则会触发所有代码操作）：
[
{
"key": "ctrl+alt+f",
"command": "editor.action.codeAction",
"args": {
"kind": "quickfix",
"apply": "first",
"source": "eslint"
},
"when": "editorTextFocus && editorLangId == javascript || editorLangId == typescript"
}
]-
ctrl+alt+f可替换成你习惯的组合；when条件确保只在 JS/TS 文件生效 - 如果按快捷键没反应，先手动右键 → “快速修复” → 看是否有 ESLint 相关选项，没有则说明 ESLint 配置未加载成功
为什么保存时自动修复经常“漏修”或报错？
常见现象是保存后部分规则没生效，或控制台报 Failed to load config "eslint:recommended"——这通常不是快捷键问题，而是 ESLint 运行上下文错乱。
- VSCode 默认使用工作区根目录下的
node_modules/.bin/eslint，但如果项目用了 pnpm/yarn2，路径可能不对，需显式配置"eslint.packageManager": "pnpm" -
"editor.codeActionsOnSave"只对“可修复”的错误生效，像no-console这类无自动修复方案的规则不会触发任何操作 - 多人协作时，有人本地全局装了 ESLint，有人只装了工作区依赖，会导致
eslint --version输出不一致，建议统一用 npx："eslint.runtime": "npx eslint"
团队规范落地时最易忽略的兼容点
快捷键只是入口，真正卡住落地的是环境一致性。比如开发机用 Node 18，CI 用 Node 16，eslint-plugin-react 的某些规则在低版本解析器里直接报语法错误，快捷键一按就弹红框。
- 务必在
.vscode/settings.json中锁定"eslint.nodePath"指向项目内node_modules下的 Node 路径，而非系统全局 - 禁止用
/* eslint-disable */注释绕过检查——它会让快捷键修复完全失效，应改用更细粒度的// eslint-disable-line react-hooks/exhaustive-deps - 团队共用的
.eslintrc.cjs必须导出函数形式（而非纯对象），才能动态判断process.env.NODE_ENV，避免开发/生产规则混用
