离线安装vscode插件必须用code --install-extension命令，图形界面“install from vsix”在内网或权限受限环境常静默失败，根本原因是扩展面板依赖后台网络通信校验签名及触发解压，断网时流程中断；命令行可直报错如“extension is not compatible with code”便于排障。
离线安装 VSCode 插件必须用 code --install-extension
图形界面点“Install from VSIX”在内网或权限受限环境常静默失败，根本原因不是操作不对，而是 VSCode 扩展面板依赖后台服务通信，断网时无法校验签名或触发解压流程。命令行方式能直接反馈错误，比如 Extension is not compatible with Code 或 ENOENT，便于快速定位。
实操要点：
- 先关闭所有 VSCode 进程（Windows 可执行
code --status确认） - 路径含空格时，Windows 必须用双引号包裹：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix" - macOS/Linux 直接使用绝对路径：
code --install-extension /Users/me/vsix/prettier-9.10.0.vsix - 若提示
command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行
editor.formatOnSave 是缩进自动修复的核心开关
缩进参考线（editor.renderIndentGuides）只是视觉辅助，它不改代码。真正修复缩进、空格、括号对齐等，靠的是保存时触发的格式化器。而这个动作的总闸门就是 editor.formatOnSave —— 它必须为 true，且对应语言的 formatter 插件已正确安装并激活。
常见误区：
- 开了
renderIndentGuides却没开formatOnSave：线条画出来了，但粘贴或手敲导致的错位永远不会被修正 - 装了 Prettier 但没设为默认 formatter：VSCode 不知道该调谁，保存时无反应
- Python 文件里
formatOnSave生效，但缩进仍是 4 空格，而项目要求 2 空格：需检查editor.tabSize和editor.insertSpaces是否与prettier.tabWidth或python.formatting.blackArgs一致
离线环境下 Python/JavaScript 自动修复依赖完整插件链
单独装一个 Python 插件（ms-python.python）不足以支持保存即修复。它本身不带格式化能力，必须搭配下游工具：Python 推荐 ms-python.black-formatter 或 ms-python.ruff；JS/TS 则需 dbaeumer.vscode-eslint + 项目级 .eslintrc.js。
离线部署关键动作：
- 下载插件时注意依赖关系：例如
ms-python.pylance是语言服务器，ms-python.python是入口，ms-python.black-formatter是格式化器 —— 三者缺一不可 - 所有插件的
package.json中"engines": { "vscode": "^1.85.0" }必须匹配你本地code --version输出的主版本号（如1.85.2兼容^1.85.0，但1.90.0就不行） - 验证 .vsix 完整性：Linux/macOS 运行
unzip -t extension.vsix；Windows 可用 PowerShellTest-Archive -Path extension.vsix，报错即说明文件损坏
手动解压 .vsix 到 extensions 目录是最后手段
当企业策略禁用扩展签名验证，或 code --install-extension 因权限问题卡死时，可跳过安装流程，直接解压到用户 extensions 目录。但这不是“复制 .vsix 文件过去”，而是必须解压、重命名、放入正确路径。
步骤不能省略：
- 用
unzip extension.vsix -d unpacked解压出内容 - 找到用户 extensions 路径：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 将解压后的文件夹重命名为
publishername.extensionname-version（如esbenp.prettier-vscode-9.10.0），再移入 extensions 目录 - 重启 VSCode 后，按
Ctrl+Shift+P输入Developer: Show Running Extensions，确认状态为Local而非Remote或空白
容易忽略的是：这种直装方式下，插件无法更新，且部分依赖动态加载 node_modules 的功能（如某些 LSP 启动逻辑）可能失效 —— 所以只应在命令行安装彻底走不通时启用。
