VSCode离线代码自动修复失效，因语言服务器（LSP）依赖网络下载二进制或校验Schema；需手动部署LSP可执行体、配置file://本地Schema路径、并显式启用editor.codeActionsOnSave等开关。
VSCode 代码自动修复功能在离线环境下无法直接使用——它依赖语言服务器（LSP）的诊断与代码操作能力，而多数 LSP 启动时会尝试联网下载二进制或校验签名。不提前准备，装完插件也只会卡在“Downloading…”或报 Schema not found。
为什么离线时“Quick Fix”和“Fix All”全失效
常见现象是右键菜单里没“Quick Fix”选项，或按 Ctrl+. 没反应；终端输出面板里反复出现 Failed to fetch 或 Unable to load schema from https://...。这不是插件没装上，而是语言服务器本身没跑起来。
- Python 插件（
ms-python.python）默认启动时拉pyright或pymaid二进制，路径写死为 CDN 链接 - ESLint 插件（
dbaeumer.vscode-eslint）需本地有eslintCLI，且配置中eslint.packageManager若设为npm，会尝试调用npm install - YAML/JSON 插件依赖远程 Schema URL，离线时
yaml.schemas或json.schemas配置项若指向 http 地址，直接跳过验证
离线部署语言服务器的三步实操法
核心思路：不靠插件自动下载，而是手动把可执行文件放到位、改配置绕过网络请求、并确保路径被正确识别。
- 先在有网机器上完整触发一次对应语言的 LSP 初始化：打开一个
.py文件 → 等状态栏显示 “Pyright activated” → 此时~/.vscode/extensions/ms-python.python-*/out/下已缓存好pyright可执行体（Linux/macOS 是二进制，Windows 是.exe） - 把整个扩展目录（如
ms-python.python-2024.10.0）打包拷到离线机的~/.vscode/extensions/，**不是只拷 .vsix** - 在离线机 VSCode 设置中显式指定 LSP 路径：
python.analysis.typeCheckingMode设为basic（避免启动 full 模式触发额外检查）；python.defaultInterpreterPath指向本地 Python 解释器绝对路径（如/usr/bin/python3）
JSON/YAML Schema 本地化配置避坑点
VSCode 的 json.schemas 和 yaml.schemas 支持 file:// 协议，但极易写错路径格式导致静默失效。
- 必须用绝对路径，且 Windows 上要双反斜杠或正斜杠：
"file:///C:/schemas/tsconfig.json"✅，"file://C:\schemas\tsconfig.json"❌ - 路径中的空格必须编码：
"file:///home/user/my%20project/schema.json"，不能留空格 - Schema 文件本身需 UTF-8 编码且无 BOM，否则 VSCode 解析失败但不报错
- 推荐把 Schema 文件统一放在工作区根目录下
.vscode/schemas/，然后配置为："file://./.vscode/schemas/tsconfig.json"（注意开头是file://+.，不是./）
插件启用后仍无修复建议？查这三项设置
即使 LSP 已就绪，自动修复也可能被策略关闭。以下三个配置项在离线环境中最容易被忽略：
-
editor.codeActionsOnSave：必须显式开启，例如{"source.fixAll": true}，默认是{}（空对象 = 全关） -
editor.quickSuggestions：若设为false，Ctrl+.就不会弹出菜单，哪怕后端已返回修复项 -
typescript.preferences.includePackageJsonAutoImports：TypeScript 插件在离线时若该值为"auto"，可能因无法访问 npm registry 而阻塞整个诊断流程，建议改为"off"
离线环境下的代码修复不是“装个插件就完事”，关键在语言服务器的二进制是否真实落盘、Schema 是否能被 file:// 正确加载、以及编辑器行为开关是否手动打开——这三处任何一环断开，都会让“自动修复”变成灰色不可用状态。
