先确认插件是否真正启用:打开扩展面板(Ctrl+Shift+X),检查开关为蓝色;若灰色需手动启用,点击无响应则说明依赖缺失(如pyright、volar-server);再新建对应类型文件(如test.py、App.vue)触发activationEvents;最后通过任务管理器或ps命令验证LSP进程是否存在,并查看Output面板对应插件日志。

插件列表里显示“已安装”但没反应,先看是否真启用了
VSCode 离线安装后默认可能禁用插件,尤其语言类(如 ms-python.python)或远程类(如 ms-vscode-remote.remote-ssh)。不手动点开开关,它就一直躺在后台不动。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索插件名,确认右侧开关是蓝色(已启用),不是灰色(已禁用)
- 若点击无响应,说明依赖未满足——比如
ms-python.python缺pyright二进制,volarjs.volar缺server/volar-server
打开对应文件类型,看状态栏和命令面板是否触发激活
很多插件只在匹配的文件打开时才加载,比如 onLanguage:python 或 onLanguage:vue。装完就去开 .txt 文件,自然什么都不会发生。
- 对 Python 插件:新建
test.py,保存后看状态栏是否出现 “Python interpreter selected”,而不是卡在 “Starting Python Server…” - 对 Volar:新建
App.vue,右下角应显示 Vue 版本号,且Ctrl+Shift+P能搜到Volar: Restart Language Server - 对 Remote-SSH:点连接后若弹出
Failed to fetch commit ID,说明本地插件版本与远程vscode-server不匹配,不是插件没装好
查进程和日志,确认语言服务器是否真正跑起来了
离线环境里 LSP 启动失败往往静默,不报错也不提示,只能靠外部验证。
- Windows:任务管理器中搜索
Code Helper或pyright进程;macOS/Linux:终端执行ps aux | grep -i volar或ps aux | grep -i pyright - 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools,切到Console标签,过滤Extension Host,找Cannot find module或Activation failed - 打开
Output面板(Ctrl+Shift+U),下拉选择对应插件名称(如Python、Volar),看是否有初始化日志或错误堆栈
验证插件目录结构是否完整,特别是 server 和 node_modules
仅拖入 .vsix 文件 ≠ 插件可运行。Volar、Python、Prettier 等都依赖预编译的 native 二进制或完整 node_modules,离线部署必须整目录迁移。
- 检查路径:
%USERPROFILE%\.vscode\extensions\volarjs.volar-1.12.0\server\(Windows)或~/.vscode/extensions/volarjs.volar-1.12.0/server/(macOS/Linux)下是否存在volar-server或volar-server.exe - 检查
ms-python.python-2024.6.0目录下是否有dist、out、node_modules三个关键子目录;缺任意一个,LSP 就无法启动 - 若目录不全,别重装
.vsix——直接从已联网机器拷贝整个扩展文件夹过来,再彻底退出 VSCode(任务管理器清空所有Code.exe进程)后重启


















