插件显示已安装但功能不生效，主因是离线安装未真正解压：必须用code --install-extension命令触发解压，而非拖入或复制；需验证code --list-extensions输出含插件id且extensions目录下存在含package.json的完整文件夹；若报“not compatible”，则需修改.vsix内package.json的engines.vscode版本范围以匹配本地code --version。
插件显示已安装但功能不生效？先确认是否真解压成功
离线环境下，VSCode 扩展面板里显示“已安装”只是表象——.vsix 文件必须经 code --install-extension 触发解压流程，才会真正写入 %USERPROFILE%\.vscode\extensions\（Windows）或 $HOME/.vscode/extensions/（macOS/Linux）。双击打开、拖进窗口、甚至手动复制到 extensions 目录，都无效。
验证方式：
- 运行
code --list-extensions，输出中必须包含插件 ID（如dbaeumer.vscode-eslint） - 检查对应插件目录是否存在且非空：比如
dbaeumer.vscode-eslint-2.4.0/下应有package.json、out/等完整结构 - 若目录只有
.vsix文件本身，说明安装根本没走通
命令行报错 Extension is not compatible with Code 怎么办
这是版本硬冲突，不是配置问题。VSCode 插件的 package.json 中 "engines": {"vscode": "^1.85.0"} 字段会严格校验当前 VSCode 版本号。
解决路径：
- 先用
code --version查清本地版本（如1.84.2） - 把下载的
.vsix当作 zip 解压，修改其extension/package.json里的vscode版本范围，例如从"^1.85.0"改成"^1.84.0"或更宽泛的=1.84.0 - 重新打包为
.vsix（可用 7-Zip 或zip -r plugin.vsix extension/），再执行安装
右下角状态栏没图标、Output 面板日志为空？可能是加载链断裂
ESLint、Prettier、C/C++ 这类依赖语言服务的插件，不会一装就亮灯。它们需要触发“首次激活”——通常靠打开对应类型文件（如 .js、.cpp）或执行相关命令。
排查要点：
- 打开一个目标语言文件（别用空白窗口），再看右下角是否出现插件标识（如 ESLint 图标）
- 按
Ctrl+Shift+P输入ESLint: Show Output Channel或C/C++: Toggle IntelliSense Engine，看是否有日志输出 - 如果 Output 面板完全空白，说明插件进程根本没启动，大概率是上一步的兼容性或解压失败导致
- 若报
Failed to load config，问题在项目级配置（如.eslintrc.js路径错误或语法非法），和离线无关
保存不自动修复、格式化静默失效？检查 VSCode 原生开关而非插件设置
很多插件（如 ESLint、Prettier）的自动修复能力，早已脱离插件自身控制，转由 VSCode 的 editor.codeActionsOnSave 统一调度。写错字段名或漏掉前置条件，就会彻底失能。
关键配置项（必须写在工作区 .vscode/settings.json 中）：
-
"editor.codeActionsOnSave": {"source.fixAll.eslint": true}—— 注意不是eslint.autoFixOnSave（v2.2.0+ 已废弃） -
"editor.formatOnSave": true—— 没它，修复动作不会进入格式化流水线 -
"eslint.format.enable": false—— 和 Prettier 共存时必加，否则抢格式化权导致光标乱跳 - Vue 文件还需额外配
"[vue]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}，否则<script></script>块不响应
离线环境最麻烦的其实是“无声失败”：没报错、没提示、就是不动。这时候得一层层确认，从插件是否真加载，到配置是否写对位置，再到格式化器是否绑定到具体语言块——漏掉任何一环，都白装。
