如何在VSCode离线安装插件后完成基础配置-VSCode-PHP中文网

插件装完没反应需先手动启用并彻底重启；语言类插件离线首启卡“starting…”是因未预置lsp服务，须整目录迁移含pyright等依赖；格式化器需在settings.json中显式绑定defaultformatter；remote-ssh连接失败主因是vscode-server版本不匹配。

如何在vscode离线安装插件后完成基础配置

插件装完但没反应？先确认是否真正启用

离线安装的插件默认处于禁用状态，VSCode 不会自动激活它。哪怕你看到扩展面板里显示“已安装”，状态栏也可能是灰色的。这不是 bug，是 VSCode 的安全策略——防止未经验证的代码自动执行。

打开扩展面板（Ctrl+Shift+X），找到刚装的插件，点击右侧的「启用」按钮（图标为 ▶️）
或者右键插件 → 选择「启用（工作区）」或「启用（全局）」
更彻底的做法：关闭所有 VSCode 实例（包括任务管理器里的 Code Helper 进程），再重新启动

语言类插件首次打开文件卡在 “Starting…” 怎么办

这是离线环境下最典型的假死现象。比如 ms-python.python 或 volarjs.volar，它们只装 .vsix 是不够的，首次启用时会静默拉取 LSP 服务（如 pyright、volar-server）。离线时无报错、无提示，就一直卡在“Starting Python Server…”。

正确做法不是重装插件，而是复用已联网机器的完整插件目录：%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\（Windows）或 $HOME/.vscode/extensions/ms-python.python-2024.6.0/（macOS/Linux）
必须整目录拷贝，包括 node_modules、dist、out 和所有子目录下的二进制文件
内网机上粘贴前，确保 VSCode 已完全退出（托盘图标也要右键退出）

格式化器不生效？检查 defaultFormatter 是否显式绑定

仅安装 esbenp.prettier-vscode 并不能让 .vue 或 .json 文件自动格式化。VSCode 默认不会把格式化行为自动关联到特定语言，除非你在 settings.json 中明确定义。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

按 Ctrl+, 打开设置 → 右上角点「打开 settings.json」

添加对应语言块，例如：

"[vue]": {
  "editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[json]": {
  "editor.defaultFormatter": "esbenp.prettier-vscode"
}

注意：不要写成 "editor.defaultFormatter": "esbenp.prettier-vscode" 全局配置，这会导致 TypeScript 等语言被错误覆盖

Remote-SSH 连不上？别查插件，先对齐 vscode-server 版本

ms-vscode-remote.remote-ssh 插件本身离线装好就能用，但连接失败（如报 Failed to fetch commit ID 或卡在 Setting up SSH Host）几乎全是远程端 vscode-server 版本不匹配导致的。

在内网 VSCode 中打开 Help → About，记下 Commit ID（如 a1859f34d7a7c259e33b423556529502890f5a3e）
用这个 ID 拼出 server 下载地址：https://vscode.download.prss.microsoft.com/dbazure/download/stable/a1859f34d7a7c259e33b423556529502890f5a3e/vscode-server-linux-x64.tar.gz（Linux 示例）
把 tar.gz 解压后整个 vscode-server 目录上传到远程机器的 ~/.vscode-server/bin/ 下对应 Commit ID 子目录中

最容易被忽略的是：VSCode 主版本号（如 1.93.x）和插件 engines.vscode 字段必须严格一致，差一个小版本都可能触发 server 重下载逻辑——而离线环境里这个过程就是静默失败。