离线VSCode格式化失效主因是语言服务器、CLI工具等运行时依赖未加载；须在有网机触发启用后整目录拷贝插件文件夹（含pyright-server、volar-server等二进制），再验证Format Document With列表及Output面板报错。
离线状态下 VSCode 格式化失效，基本不是插件没装上，而是关键依赖根本没加载进来——code --install-extension 只解压了入口文件，pyright-server、prettier-cli、volar-server-darwin-arm64 这类二进制或语言服务器，全靠首次启用时联网下载。离线环境里它们压根不存在。
怎么确认格式化器真被加载了
别信扩展面板里的“已安装”三个字。VSCode 离线加载插件是静默的，失败也不报错。
- 按
Ctrl+Shift+P输入Format Document With，列表为空？说明当前语言 ID 下没注册任何格式化器 - 打开
View → Output，切换到对应插件通道（如Prettier、Python），看有没有spawn ENOENT或Failed to load module - 状态栏卡在
Downloading...或Initializing...？这就是 LSP 服务没拉下来，不是配置问题，是缺文件
离线安装必须补全的三类东西
.vsix 文件只是个壳，真正干活的是它背后运行时才加载的组件。离线部署必须手动带齐：
-
语言服务器二进制：比如
ms-python.python的pyright-server，藏在dist/server/或out/子目录下；volarjs.volar的volar-server-darwin-arm64在server/目录里 -
CLI 工具包：如
esbenp.prettier-vscode首次启用会尝试下载本地prettierCLI，Windows 下常落在node_modules/.bin/，离线必须整份拷 -
扩展目录结构完整性：不能只拷
package.json或out/，要整个插件文件夹（如ms-python.python-2024.6.0/），含所有子目录和隐藏文件
拖拽 .vsix 没反应？先看窗口状态
这不是 bug，是 VSCode 的硬性限制：拖放只在特定窗口状态下生效。
- 必须已加载工作区——哪怕只是打开一个空文件夹；纯启动页或远程连接未就绪时，拖进去等于扔空气
- 主窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是重命名过的prettier.vsix.zip，也不是解压后的文件夹 - 校验命令：
unzip -l your.vsix应显示顶层为extension/目录，否则压缩包已损坏
JSON/Vue/Python 格式化仍不触发？检查语言绑定链
格式化是分层触发的：文件后缀 → 语言模式 → 格式化器绑定 → 实际执行。断一环就静默失败。
- 右下角状态栏显示
Plain Text或Unknown？点它，手动选jsonc、vue、python，大小写必须完全匹配 -
files.associations配置会劫持识别逻辑，例如"*.json": "plaintext"会让 JSON 插件彻底失效 -
[vue]块只控制整个文件默认格式化器，vetur.format.defaultFormatter.*才决定这种块用谁来格式化 - Python 补全失效？不是插件没装，是
pyright服务没起来——Output 面板切到Python通道，找initialization finished字样，没有就说明缺二进制
最易被忽略的一点：离线环境下，editor.defaultFormatter 配置本身不会触发任何下载，但它必须存在且正确指向已加载的插件 ID；而插件 ID 是否可用，取决于你有没有把整个扩展目录（含所有子目录里的 native 二进制）完整拷过去。
