离线环境下 VSCode 无法用原生功能检测代码重复,必须提前在外网准备好可离线运行的静态分析工具链;只装插件不配 CLI 和规则包,点击“查找重复”会静默失败或报 ESLint server is not running。

离线环境下 VSCode 无法用原生功能检测代码重复,必须提前在外网准备好可离线运行的静态分析工具链;只装插件不配 CLI 和规则包,点击“查找重复”会静默失败或报 ESLint server is not running。
CodeMirror Duplicate Finder 离线安装后不生效?检查这三件事
该插件虽轻量,但离线启动依赖完整路径和基础环境:
- 必须已打开一个文件夹(
File → Open Folder),不能停留在 Welcome 页面——否则右键菜单里根本不会出现Find Duplicates in Workspace - 插件本身不校验版本兼容性,但 VSCode 1.80+ 默认禁用未签名插件;若拖拽
.vsix后无任何提示,先运行code --version,再解压.vsix查package.json中"engines": {"vscode": "^1.75.0"}是否匹配 - Windows 路径含中文或空格时,命令行安装必须加英文引号:
code --install-extension "D:\vsix\duplicate-finder-2.4.0.vsix"
为什么装上了却找不到重复代码?缺的是规则 + 扫描范围控制
插件默认跳过注释、字符串、JSX 和 node_modules,而你真正想查的重复逻辑可能就藏在这些地方:
- 启用
"duplicate-finder.includeStrings": true才能扫描模板字符串里的相似逻辑块 - 在
settings.json中显式排除干扰目录:"duplicate-finder.exclude": ["**/dist/**", "**/build/**"] - 若项目用 Vue 或 TS,确保
.gitignore没把src/下的子目录全 exclude 掉——插件读不到文件,自然不扫描
真正要查“语义重复”,得靠 ESLint + plugin
CodeMirror 只做行级文本比对,对变量名替换、缩进差异、箭头函数/普通函数切换完全无感。离线可用的替代方案是:
- 在外网机器上执行:
npm pack eslint@8.57.0 eslint-plugin-import@2.29.1,得到两个.tgz包 - 拷贝到离线机项目根目录,运行:
npm install --offline ./eslint-8.57.0.tgz ./eslint-plugin-import-2.29.1.tgz - 配置
.eslintrc.cjs启用规则:'no-duplicate-case': 'error'和'no-unreachable': 'error'(这类规则不依赖网络,纯本地 AST 分析) - VSCode 设置中确认:
"eslint.enable": true,且"eslint.packageManager": "npm"(别设成yarn或pnp)
最易被忽略的一点:插件扫描的是“当前打开的文件”或“工作区中已加载的文件”,不是磁盘上所有文件。如果某个 .js 文件没被 VSCode 缓存(比如刚从 U 盘复制进来但没点开过),它就不会出现在重复检测结果里——这不是 bug,是设计如此。


















