code命令不可用导致安装失败，需先用which/where确认存在，再通过VSCode命令注册到PATH；插件未出现在extensions目录是因权限或自定义路径问题；拖拽安装失败多因GUI环境未就绪或文件路径异常；离线安装后不生效常因语言服务器未预下载。
code --install-extension 报“找不到文件”或静默失败
根本不是路径写错了，而是 code 命令本身不可用，或者终端环境压根没加载到它。VSCode 官方包（.deb/.rpm/ZIP）默认不自动把 CLI 工具注册进系统 PATH，尤其在 SSH、WSL 或非交互式 shell 中极常见。
- 先运行
which code（Linux/macOS）或where code（PowerShell），无输出就说明命令未就绪 - 临时解决：用绝对路径执行，如
/usr/bin/code --install-extension /home/user/ext/python.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /Users/me/ext/prettier.vsix（macOS） - 永久修复：在 VSCode 中按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车，再重启终端 - Windows 用户注意：
cmd.exe和Powershell的 PATH 不互通，需分别验证；别用反斜杠拼路径，统一用正斜杠更稳妥，如C:/ext/ms-python.python-2024.6.0.vsix
装完插件却在 ~/.vscode/extensions 里找不到文件夹
这不是安装跳过，是 VSCode 在写入阶段被权限或路径策略拦住了——它不报错，只丢弃操作。最常触发的场景是自定义了 extensions.installDir，但路径不存在、不可写，或指向了系统保护区域。
- 打开 VSCode 设置（
Ctrl+,），搜索extensions.installDir，如果该配置存在，先注释或删掉它，让 VSCode 回归默认路径 - 确认默认目录可写：
ls -la ~/.vscode/extensions/（Linux/macOS）或dir %USERPROFILE%\.vscode\extensions（Windows），若提示Permission denied，运行sudo chown -R $(whoami) ~/.vscode - 别把扩展目录设到
/usr/local、C:\Program Files这类需要管理员权限的路径，哪怕你用了管理员身份启动 VSCode - WSL 或企业 NTFS 卷上，挂载点可能默认属主为
root，导致普通用户无法写入；可加--extensions-dir指向家目录下的子路径，如code --extensions-dir ~/.vscode-offline-ext --install-extension python.vsix
拖拽 .vsix 到窗口后卡在 “Installing…” 或完全没反应
图形界面安装依赖后台网络请求调度解压流程，断网时它不提示错误，只挂起或忽略事件。这和插件本身无关，纯粹是 GUI 环境未就绪。
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未建立时，拖放事件被直接忽略
- 确保窗口有系统焦点：任务栏图标高亮，且不能处于全屏、RDP/TeamViewer 控制下或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹，也不是.vsix.zip这类双后缀文件（Windows 会静默解压） - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖 - 验证文件完整性：
unzip -l plugin.vsix应显示顶层为extension/目录，且含extension/package.json
离线安装后插件不生效，尤其是 Python、Java、Verilog 类语言扩展
这些插件的 .vsix 只是前端壳，真正干活的语言服务器（如 pyright-server、java-language-server）需首次启用时联网下载。离线环境下，它就卡在“Downloading…”或直接静默跳过，结果打开文件就是纯文本。
- 必须提前下载对应语言服务器二进制：比如
redhat.java插件要求的java-language-server，得去其 GitHub Release 页面手动下载匹配架构（x64/ARM）和平台（Linux/macOS/Windows）的压缩包 - 解压后，按插件文档说明，把 server 放到
~/.vscode/extensions/redhat.java-*/server/下（路径以实际插件 ID 和版本为准） - 检查
package.json中的extensionDependencies字段，如ms-python.python强依赖ms-toolsai.jupyter，离线时必须一并下载安装所有依赖项 - 装完务必彻底退出 VSCode：右下角托盘图标也要右键“Quit”，否则缓存不刷新，新插件不会加载
离线安装最麻烦的从来不是“怎么装”，而是“装完之后谁来干活”。语言服务器、依赖插件、CLI 注册、权限路径——每个环节都可能静默失效，且几乎不报错。盯着 ~/.vscode/extensions 目录看一眼，比反复重试更有效。
