离线部署vscode-server需手动上传对应commit id的压缩包至~/.vscode-server/并解压，再创建空文件touch ~/.vscode-server/0禁用自动下载；同时确保code命令已注册path、插件版本兼容、拖拽满足焦点/非全屏/原始.vsix等四条件，并关闭settings.json中触发网络请求的配置项。
vscode-server 离线部署时如何跳过自动下载
远程开发连接失败，十有八九卡在 vscode-server 自动下载环节。离线机器上它会反复尝试从 GitHub 或 Azure CDN 拉取二进制包，最终超时断连。
核心解法是提前把 vscode-server 压缩包放到目标机器，并用空文件 0 显式禁用自动下载逻辑：
- 将外网下载好的
vscode-server-linux-x64.tar.gz（或对应架构）上传到远程机器的~/.vscode-server/目录下 - 解压：
tar -xzf vscode-server-linux-x64.tar.gz -C ~/.vscode-server/ - 创建禁用标记：
touch ~/.vscode-server/0
注意：路径必须是 ~/.vscode-server/，不是 ~/.vscode-server-insiders/；0 文件必须为空且无扩展名，否则无效。
用 code --install-extension 安装 .vsix 但提示 command not found
code --install-extension 是批量部署的主力命令，但它依赖 CLI 工具注册到系统 PATH。内网机器常因未启用 Shell 命令而报错 command not found: code。
解决路径很直接：
- 先在 VS Code 中按
Ctrl+Shift+P，输入并运行Shell Command: Install 'code' command in PATH - 重启终端（旧终端进程不读新 PATH）
- 安装时必须用绝对路径，且含空格/中文需加英文双引号：
code --install-extension "D:/ext/ms-python.python-2024.6.0.vsix"
别用相对路径——./ext/xxx.vsix 在多数场景下会静默失败。
拖拽 .vsix 到编辑区没反应？检查这四个条件
这是离线环境下成功率最高的安装方式，但“没反应”不是功能失效，而是触发条件没满足：
- VS Code 必须已启动，且窗口处于**系统焦点状态**（任务栏图标高亮，非最小化）
- 不能处于全屏模式，也不能通过 RDP / TeamViewer / AnyDesk 这类远程桌面工具操作（它们会拦截 OS 级拖放事件）
- 拖的是原始
.vsix文件，不是解压后的文件夹，也不是重命名成.zip的压缩包 - 插件要求的 VS Code 版本需兼容，例如插件
engines.vscode字段写"^1.85.0"，你就不能用1.82.3
只要四者齐备，松手瞬间就会弹出确认框，整个过程不联网、不校验签名、不依赖任何外部服务。
settings.json 里哪些配置项会偷偷触发网络请求
看似纯本地的设置，有些字段会在后台发起 HTTP 请求，导致离线环境卡顿或报错：
-
"typescript.preferences.importModuleSpecifier": "relative"—— 正常，但设为"auto"时可能查 npm registry -
"eslint.packageManager"若设为"yarn"却没装 yarn，ESLint 插件会尝试 fetch yarnpkg.com -
"editor.suggest.showWords"默认开启，但某些语言服务器（如 rust-analyzer）在离线时会反复 retry LSP 初始化 - 最隐蔽的是
"workbench.colorTheme"：若设为未安装的主题 ID（如"One Dark Pro"），VS Code 会尝试从市场搜同名插件
建议离线环境统一用内置主题（"Default Dark+）、关掉所有自动补全推荐开关，并在 Developer: Toggle Developer Tools 的 Console 里搜 fetch 或 XMLHttpRequest 快速定位源头。
git.autofetch 开关，或某插件悄悄启用的 telemetry 上报，都可能让整个环境在你认为“已完全离线”的状态下持续尝试连接。
