VSCode离线环境插件管理_VSCode自动处理代码规范【操作】-VSCode-PHP中文网

vscode离线环境下eslint自动修复需满足三前提：插件正确安装并解压、项目配置文件（如.eslintrc.js）被识别、settings.json中明确配置"editor.codeactionsonsave": {"source.fixall.eslint": true}；离线不导致失效，但使依赖和错误排查失去网络兜底。

vscode离线环境插件管理_vscode自动处理代码规范【操作】

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 原生的代码操作机制：

Text To Image

一款AI图像与设计工具，主要用于将文本渲染为图片并返回临时本地文件路径，支持可选的 data URI。适用于 Clawhub 或 Codex，用于将纯文本或带样式的文本进行转换，适合需要提升相关任务效率的用户。

下载

必须在工作区级 .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），排除干扰