离线安装vscode插件需整目录迁移而非仅拷贝vsix：先在联网机启用插件触发lsp/cli下载（如python需等pyright就绪），再复制整个~/.vscode/extensions/ms-python.python-xxx/目录到内网机对应路径，配合code --install-extension命令行安装并验证版本兼容性。
离线安装 VSCode 插件本身不难，真正卡住人的不是“装不上”，而是“装上了却用不了”——尤其是 Python、Prettier 这类语言插件，首次启用时会静默尝试下载 pyright、prettier CLI 或 LSP 服务，离线环境下状态栏卡在 Downloading…，输出面板刷满 Failed to fetch。
vsix 文件下载必须来自官方 Marketplace
别信第三方打包站或“VSCode 插件合集”压缩包。这些 .vsix 常被篡改、签名失效，或缺失 package.json 中的 engines.vscode 字段校验逻辑，导致安装直接报 Extension is not a valid VS Code extension。
- 正确路径：打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ 找右上角Download Extension按钮 → 下载的是带签名、结构完整、版本明确的原始 .vsix - 验证方式：用
unzip -t your-extension.vsix检查压缩包是否损坏；再用unzip -p your-extension.vsix extension/package.json | grep vscode确认"vscode": "^1.85.0"与你本地 VSCode 版本兼容（Help → About 里看） - Windows 用户注意：浏览器可能把 .vsix 自动重命名为
xxx.vsix.zip，别右键改后缀，用 PowerShell 执行Copy-Item "old.zip" "new.vsix" -Force
code --install-extension 是离线安装唯一可靠入口
图形界面（拖拽 / Install from VSIX）在企业策略、多显示器缩放、远程 SSH 未就绪等场景下容易静默失败；而 code --install-extension 命令行能立刻返回错误，比如 ENOENT（CLI 未注册）、Extension 'xxx' is not compatible with Code（版本不匹配），问题边界清晰。
- 先确保
code可用：终端运行code --version，失败则在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - Windows 路径含空格必须加双引号：
code --install-extension "C:\ext\ms-python.python-2024.6.0.vsix" - macOS/Linux 必须用绝对路径：
code --install-extension /opt/vscode-ext/esbenp.prettier-vscode-9.10.3.vsix - 静默覆盖旧版加
--force参数，但注意：这不会清理旧版本残留的node_modules，冲突时建议先手动删掉~/.vscode/extensions/ms-python.python-*再装
语言插件离线能用的关键是整目录迁移，不是只拷 vsix
装完 ms-python.python.vsix 后打开 .py 文件，状态栏仍卡 Downloading…？这不是安装失败，是插件启动时试图拉取 pyright 二进制——这个动作无法离线完成，必须提前在有网机器上触发并打包整个扩展目录。
- 操作流程：在联网机器上打开任意
.py文件 → 等状态栏变绿（表示pyright已下载完成）→ 进入~/.vscode/extensions/找到类似ms-python.python-2024.6.0/的完整文件夹 → 整个复制到内网机对应路径 - 不能只复制 .vsix 文件进去，也不能解压后丢掉外层目录直接塞内容；VSCode 只识别
publishername.extensionname-version格式的子目录名 - 验证是否真生效：重启 VSCode 后，按
Ctrl+Shift+P输入Python: Select Interpreter，能弹出选项才算成功；再看输出面板 →Python通道里不应有spawn ENOENT或fetch错误
editor.formatOnSave 和 editor.detectIndentation 不是离线专属，但离线时更依赖它们
离线环境没法靠 ESLint/Prettier 插件实时格式化，"editor.formatOnSave": true 就成了最轻量的兜底方案；而 "editor.detectIndentation": true（默认开启）配合项目根目录的 .editorconfig，能让 VSCode 自动识别缩进风格，避免手动调 Convert Indentation。
-
.editorconfig必须保存后才生效，改完记得Ctrl+S - 路径匹配严格：从当前文件逐级向上找，遇到
root = true就停；多个同名文件只认最靠近的那个 - 后缀未注册的语言（如
.astro、.svelte）需在.editorconfig显式声明段落：[*.astro]，否则缩进检测失效
真正麻烦的从来不是“怎么装”，而是“装完之后它到底在后台干了什么”。语言插件的 LSP 服务、格式化工具、语法检查器，这些都不是 .vsix 包里自带的——它们是运行时动态加载的独立二进制，离线部署必须把“执行过一次后的完整扩展目录”当整体搬运，漏掉 node_modules 或 dist/server 里的某个文件，就会在某个不起眼的角落突然失效。
