VSCode离线环境下ESLint自动修复需满足三前提：插件正确安装并解压、项目配置文件（如.eslintrc.js）被识别、settings.json中明确配置"editor.codeActionsOnSave": {"source.fixAll.eslint": true}；离线不导致失效，但使依赖和错误排查失去网络兜底。
VSCode离线环境下，ESLint 插件能自动修复代码规范问题，但前提是：插件已正确安装、配置文件被识别、且 VSCode 的保存行为明确指向 ESLint 修复逻辑——这三者缺一不可。离线环境不会让 ESLint 失效，但会让错误更难排查，因为没有网络兜底（比如自动拉依赖、查文档、重装插件）。
VSCode 离线安装 ESLint 插件后不生效？先确认这三件事
离线安装 dbaeumer.vscode-eslint 后右下角没显示“ESLint”，不是插件坏了，而是加载链断在某个环节：
- 检查
.vsix文件是否真的解压进了%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）——只把.vsix文件丢进去是无效的，必须由code --install-extension触发解压流程 - 运行
code --list-extensions，看输出里是否有dbaeumer.vscode-eslint；若无，说明安装失败，常见原因是 VSCode 版本与package.json中"engines": {"vscode": "^1.85.0"}不匹配 - 打开一个
.js或.ts文件，按Ctrl+Shift+P输入ESLint: Show Output Channel，如果日志为空或报Failed to load config，说明项目级配置没被读到，不是插件问题
离线时 ESLint 自动修复失效，90% 是 settings.json 没写对
eslint.autoFixOnSave 已在插件 v2.2.0+ 中彻底移除，继续写它毫无作用。真正起效的是 VSCode 原生的代码操作机制：
- 必须在工作区级
.vscode/settings.json中显式写入："editor.codeActionsOnSave": {<br> "source.fixAll.eslint": true<br>} - 同时确保
"editor.formatOnSave": true—— 否则即使规则可修复，VSCode 也不会触发格式化流水线 - 不要写
"source.fixAll": true，它会尝试调用所有启用的 linter（比如 Prettier + ESLint 共存时直接报错） - 如果项目还用了 Prettier，必须额外设
"eslint.format.enable": false，否则两个工具会抢着改同一行，导致光标乱跳或保存卡住
离线项目里 .eslintrc.js 不被识别？检查这些硬性条件
VSCode ESLint 插件默认只从工作区根目录加载配置，且对文件名、导出语法、Node.js 加载方式极其敏感：
- 配置文件必须是以下之一：
.eslintrc.js、.eslintrc.cjs、.eslintrc.json，或package.json中的eslintConfig字段；.eslintrc.ts或eslint.config.js（Flat Config）需插件 ≥ v2.4.10 且开启eslint.experimental.useFlatConfig: true -
.eslintrc.js必须用module.exports = { ... }，不能用export default { ... }，否则 Node.js 加载失败 - TypeScript 项目必须在配置中声明
parserOptions.project（如"./tsconfig.json"），否则@typescript-eslint/no-unused-vars这类规则根本不会运行 - Vue 单文件组件、
.tsx、.server.tsx等非标准后缀，必须在配置的overrides或files字段中显式列出，否则 ESLint 直接跳过
离线环境验证 ESLint 是否真在工作？别信扩展列表
扩展面板显示“已安装” ≠ 能用。离线场景下，最可靠的验证方式是实操加日志：
- 在项目里新建一个
test.js，写一行console.log('hello');（假设你启用了no-console），保存后看编辑器是否标红并提示 ESLint 错误 - 打开命令面板，运行
ESLint: Show Output Channel，正常应看到类似ESLint server running in node v18.17.0和加载了哪些规则的日志 - 终端执行
npx eslint --print-config src/test.js（替换为实际路径），若报Failed to load config，说明配置路径、语法或依赖缺失，和插件无关 - 如果修复仍不生效，临时删掉
node_modules外的其他 lint 类插件（如 Prettier、Stylelint），排除干扰
离线环境最大的陷阱，是把“没联网”当成万能归因。其实 ESLint 的核心能力（解析、校验、fix）全部本地执行，真正容易断掉的，是配置加载路径、Node.js 模块解析、以及 VSCode 编辑器行为与插件之间的契约约定——这些细节一旦错位，就不会有报错提示，只会静默失效。
