VSCode离线环境下代码补全失效，主因是语言服务组件未下载或依赖远程API；需手动安装兼容版本插件、拷贝完整扩展目录（含node_modules和二进制）、配置本地模型及禁用网络请求。
离线环境里 VSCode 本身能跑，但自动填充代码逻辑（比如补全、注释生成、函数建议）基本失效——不是插件没装上，而是绝大多数 AI 或语言服务类插件默认依赖外网下载 runtime、调用远程 API 或拉取 language server。必须手动切断对外依赖链，并替换为本地可执行组件。
code --install-extension 命令报 “Extension is not compatible” 怎么办
这个错误几乎全是版本不匹配导致的，和网络无关。VSCode 安装时会严格比对 package.json 里的 "engines": {"vscode": "^1.75.0"} 和你本地 code --version 输出的主版本号（如 1.85.2 → 取 1.85）。
- 解压
.vsix（它本质是 zip），打开根目录下的package.json，检查engines.vscode字段是否兼容你当前 VSCode 版本 - ARM Mac 上误装 x64 构建的插件（尤其含 native 二进制的，如
pyright、esbuild），也会触发该报错；需找带darwin-arm64标识的版本 - Windows 下路径含空格必须加双引号：
code --install-extension "C:\my ext\python-2024.6.0.vsix" - macOS/Linux 必须用绝对路径：
code --install-extension /opt/vscode-ext/ms-python.python-2024.6.0.vsix
Python 补全/格式化不生效，但插件显示“已安装”
这是离线环境最典型的假成功：插件装上了，但关键依赖没加载。像 ms-python.python 这类语言插件首次启用时，会自动下载 pyright 或 python-language-server，离线环境下卡在状态栏 “Downloading…” 或输出面板报 Failed to fetch。
- 不要重装
.vsix，而是在有网机器上完整走一遍流程：打开一个.py文件 → 等状态栏变绿（表示 LSP 已就绪）→ 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0）原样拷到内网机对应路径 - 确认扩展目录下存在
node_modules和可执行二进制（如pyright），否则只是空壳 - 重启 VSCode 前，确保托盘进程已完全退出（右键任务栏图标 → 退出），否则旧缓存可能继续干扰
CodeGeeX 离线启用本地补全要配哪三项
官方 CodeGeeX 插件默认走智谱云 API，离线必须强制切到 Ollama 托管的 codegeex4 模型，且三处配置缺一不可，少一个都会静默失败。
- 开启
codegeex.localMode：这是总开关，不勾选则所有后续配置无效 -
codegeex.apiBase设为http://localhost:11434/v1/chat/completions（注意末尾路径必须是/v1/chat/completions，填成/chat/completions或/v1/completions都会 404） -
codegeex.model填codegeex4，且codegeex.apiKey必须留空（填任意值都会触发云端验证） - Ollama 必须监听
127.0.0.1:11434，Linux/macOS 还要提前设OLLAMA_ORIGINS="*"，否则 Chromium 内核拦截 CORS 请求
拖拽 .vsix 到窗口没反应，常见原因有哪些
拖拽是最稳的离线安装方式，但失败往往卡在环境状态而非文件本身。
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），不能停留在空白启动页或远程连接未就绪状态
- 右下角状态栏显示
Extensions disabled by policy：说明企业组策略已禁用全部扩展安装，GUI 和 CLI 都会失效 - 焦点不在 VSCode 窗口、全屏遮挡、多显示器缩放偏移，都可能导致拖拽坐标识别失败
- 双击
.vsix文件无效——Windows 默认可能用浏览器打开，或报“无法安装”，必须拖进编辑器主区域（写代码那块白底区）松手弹框才算成功
真正难的不是装上插件，而是让每个插件的子依赖（LSP、CLI、模型权重、跨域许可）全部在离线状态下就位。一个环节断掉，补全就停在“正在加载…”——这种问题不会报错，只会沉默。
