VSCode离线安装ESLint插件最可靠方式是直接从官方Marketplace下载.vsix文件,但需注意该插件不自带eslint CLI及依赖模块,须在项目中单独安装node_modules并配置.eslintrc.js或package.json eslintConfig,否则无法校验代码。

直接下载 VSIX 文件是最可靠的方式
VSCode 离线安装插件没有「在线同步」路径,必须手动获取 .vsix 安装包。ESLint 插件(官方名 dbaeumer.vscode-eslint)不依赖 VSCode 市场直连,但它的依赖项(比如 eslint 本身)仍需本地存在——这点常被忽略。
操作要点:
- 在有网络的机器上打开 VS Code Marketplace 页面,点击右上角 Download Extension,保存为
dbaeumer.vscode-eslint-2.4.10.vsix(版本号随时间变化) - 不要用第三方打包站或 GitHub Release 下载——那些不是 VSIX 格式,也不能直接安装
- 该插件本身不带
eslintCLI,你仍需在目标机器的项目中通过npm install eslint(或yarn add eslint)本地安装,否则插件报错ESLint server is not running
离线安装时插件报“依赖缺失”怎么办
VSIX 包只含插件逻辑,不包含它所调用的 Node.js 模块。常见报错如:
Failed to load plugin 'import' declared in '.eslintrc.js': Cannot find module 'eslint-plugin-import'
这说明你的项目里没装对应插件,和 VSIX 无关。解决方式是:
- 把整个
node_modules目录(含eslint、eslint-plugin-xxx等)从联网机复制到离线机的项目根目录 - 确保
package.json中已声明这些 devDependencies,否则后续更新或 CI 会断链 - 如果用 pnpm,注意
pnpm store不可跨机器复用,必须完整拷贝node_modules或重新pnpm install --offline(前提是你已有pnpm-lock.yaml和缓存)
安装后 ESLint 不提示、不校验代码
离线环境最容易卡在这步:插件装上了,但编辑器没反应。关键检查点:
- 确认项目根目录下有
.eslintrc.js、.eslintrc.json或eslintConfig字段在package.json中——没有配置,插件默认不启用任何规则 - 检查 VSCode 设置里的
eslint.enable是否为true(默认是 true,但某些企业策略可能禁用) - 打开命令面板(
Ctrl+Shift+P),运行ESLint: Show Output Channel,看输出里是否有Failed to load config或Cannot resolve类错误 - 若用 TypeScript,确保已安装
@typescript-eslint/parser和@typescript-eslint/eslint-plugin,且.eslintrc.js中 parser 配置正确,例如:parser: '@typescript-eslint/parser'
node_modules 和配置文件里。漏掉任意一层,都会表现为“装了等于没装”。


















