code --install-extension 命令无响应或报 ENOENT，主因是旧 code 进程锁死扩展目录或 CLI 未注册 PATH；需先用 code --status 检查残留进程，结束所有 Code.exe/extensionHost 等后台任务，再确保 extensions 目录权限属当前用户且无杀软拦截。
code --install-extension 命令无响应或报 ENOENT
不是网络问题，也不是插件坏了，而是 code 进程被旧实例锁死，或者 CLI 本身没注册进系统 PATH。VSCode 的离线安装依赖主进程释放扩展目录写权限，一旦后台有残留进程在读写 $HOME/.vscode/extensions 或 %APPDATA%\Code\User\settings.json，命令就会卡住或直接报路径不存在。
- 先运行
code --status：若输出中显示多个main、shared-process或extensionHost进程，说明有未退出的后台任务 - Windows 用户用任务管理器搜索
Code.exe，Linux/macOS 执行pkill -f "code.*--extensions"或killall -u $USER code - 别只关窗口——右下角托盘里的
Code Helper (Renderer)和GPU Process也得手动结束 - 执行
code --install-extension前，确保当前终端没有其他code命令正在后台运行（比如你刚试过拖拽安装，它可能还在解压）
拖拽 .vsix 后卡在 “Installing…” 且无错误提示
图形界面安装本质是调用同一个扩展主机进程，但 UI 层不暴露底层错误。它会在焦点丢失、路径不可写或进程被占用时静默挂起，而不是报错。
- 确认 VSCode 窗口有焦点：任务栏图标是否高亮？远程桌面（RDP/TeamViewer）下拖放常被拦截，改用 CLI
- 检查
.vsix文件是否被其他程序打开：比如你用 VSCode 自己打开了这个文件（会自动解压预览），会导致 ZIP 句柄被占 - 临时关闭杀毒软件或 Windows Defender 实时保护——某些安全软件会 hook
CreateFile调用，阻塞对extensions目录的写入 - macOS 上注意 Spotlight 或 Time Machine 是否正在索引
~/.vscode目录，可用lsof +D ~/.vscode/extensions查看谁在占用
插件显示已安装但不生效，重启后仍消失
这不是安装失败，而是进程残留导致的缓存未刷新或目录写入不完整。VSCode 启动时会扫描 extensions 目录并加载 JSON 元数据，如果安装中途被中断，可能只写入了部分文件。
- 手动检查目标目录：
ls -la ~/.vscode/extensions/ | grep -i your-extension-id（Linux/macOS）或dir %APPDATA%\Code\Extensions /b | findstr /i "your-id"（Windows） - 若看到类似
ms-python.python-2024.6.0.part或.tmp结尾的临时目录，说明上一次安装被强行终止，删掉再重试 - 不要只删
.vsix文件——要清空整个对应 ID 的子目录，否则 VSCode 会尝试加载损坏的元数据 - 安装后必须彻底退出 VSCode（包括托盘进程），再重新启动；仅
Developer: Reload Window不会重建扩展主机
Linux/macOS 下 extensions 目录权限异常导致静默失败
VSCode 默认以当前用户身份运行，但如果你曾用 sudo code --install-extension 或在 root shell 里执行过安装，extensions 目录所有权可能变成 root，普通用户后续无法写入。
- 运行
ls -ld ~/.vscode/extensions：若 owner 不是当前用户（如显示root root），就是权限根源 - 修复命令：
sudo chown -R $USER:$USER ~/.vscode/extensions（macOS/Linux）或icacls "%APPDATA%\Code\Extensions" /reset /T（Windows） - 避免未来踩坑：永远不用
sudo跑code命令；CLI 注册也必须在普通用户终端里完成 - 特别注意 Docker 或 WSL 环境：若
.vscode挂载自 Windows 主机，NTFS 权限映射可能导致 Linux 子系统无法写入
真正卡住离线安装的，往往不是插件本身，而是你没意识到 VSCode 的扩展系统在后台持续持有文件句柄和目录锁。哪怕只开过一次设置页，它都可能让 extensions 目录处于“半占用”状态。
