私有云离线部署VS Code语言插件需满足三要素：安装.vsix包、手动放置对应LSP server二进制至插件目录指定路径、在settings.json中显式配置server路径并禁用telemetry/auto-update等联网行为；仅装插件无法启用，必须右下角显示server就绪、可补全、可跳转定义才算真正可用。
私有云服务上无法直接访问 VS Code 扩展市场，语言支持插件必须离线部署 —— 这不是权限问题，是网络策略切断了 marketplace 请求链路。
确认插件是否真能离线运行
不是所有语言插件都“装上就能用”。比如 C/C++ 插件依赖本地 clangd 或 Microsoft C/C++ extension 自带的 server 二进制；Python 插件默认要拉 pylsp 或 pyright，但这些 server 不随插件自动下载。离线环境里，只装 .vsix 包大概率会卡在“Language Server starting…”。
- 优先选自带 LSP 的插件：如
rust-analyzer、gopls（Go 官方 server）、zls（Zig）——它们的.vsix包里已打包好可执行文件 - 避开需额外下载 server 的插件：
Python（除非你手动部署pyrightCLI）、PHP Intelephense（商业版需联网激活）、Vue Language Features（依赖volar-server单独分发） - 验证方式：装完后打开对应语言文件，看右下角状态栏是否显示 server 名称和就绪状态，而不是一直转圈或报
Failed to start language server
手动部署 .vsix + 补充 server 的完整路径
离线部署 = .vsix 安装 + 二进制 server 放对位置 + settings.json 显式指向。三者缺一不可。
- 从官网或可信镜像下载插件：
https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools→ 点“Download Extension”得ms-vscode.cpptools-*.vsix - server 二进制不能放错目录：VS Code 默认不自动解压 server，需手动放进插件目录下的
out/server/或dist/（具体看插件文档），例如C/C++插件要求cpptools-srv在~/.vscode/extensions/ms-vscode.cpptools-*/out/linux/x64/ - 强制指定 server 路径：在
settings.json中写死，避免插件自己瞎猜{ "C_Cpp.intelliSenseEngine": "Default", "C_Cpp.clang_format_path": "/opt/vscode-servers/clang-format", "C_Cpp.customProviders": ["/opt/vscode-servers/cpptools-srv"] }
配置 settings.json 避免自动触发联网行为
很多语言插件默认开启 telemetry、auto-update、online schema fetch，私有云里这些行为会卡住初始化，甚至让整个插件进程 hang 住。
- 禁用所有上报：
"telemetry.telemetryLevel": "off" - 关掉自动检查更新：
"extensions.autoUpdate": false，并确认extensions.ignoreRecommendations设为true - 禁用远程 schema：
"html.suggest.html5": true没问题，但要删掉类似"json.schemas"里指向https://...的条目 - 关键项：设置
"files.associations"和"[language]": {...}块，确保插件在无网络时也能识别文件类型，否则连语法高亮都失效
验证是否真正可用的三个硬指标
别信“安装成功”弹窗。真正离线可用，必须同时满足：
- 打开对应后缀文件（如
main.rs），右下角显示rust-analyzer (ready)，不是starting…或空白 - 按
Ctrl+Space能触发补全，且候选项来自本地分析（不是空列表或“Loading…”） - 把光标停在函数名上，按
F12能跳转到定义，且不弹Unable to resolve definition
最容易被忽略的是 server 的 libc 兼容性：私有云用的可能是较老的 glibc，而新版本 rust-analyzer 或 zls 编译时用了新符号。遇到 cannot open shared object file，就得回退 server 版本，或用 ldd 检查缺失依赖。
