code --install-extension 命令必须在 VSCode 完全退出后执行，否则因进程锁冲突而静默失败；路径含空格须用引号包裹；离线安装需加 --allow-unverified 参数。
code --install-extension 命令必须在 VSCode 完全退出后执行
VSCode 的 CLI 安装逻辑会尝试连接主进程注册扩展，如果已有窗口或后台服务在运行，code --install-extension 可能静默失败、不报错也不生效。这不是权限问题，而是进程锁冲突。
实操建议：
- Windows：先运行
code --status确认无残留进程；若有，用taskkill /f /im Code.exe - macOS/Linux：用
ps aux | grep -i code | grep -v grep检查，存在则killall -u $USER Code - 脚本开头加 sleep 1s —— 防止上一个 VSCode 进程刚退出但文件句柄未释放完
路径含空格或特殊字符时必须用双引号包裹
尤其 Windows 下常见路径如 D:\My Tools\extensions\ms-python.python-2024.6.0.vsix，不加引号会导致 code 命令只读到 D:\My 就截断，报 ENOENT 或直接跳过。
实操建议：
- 所有路径统一用绝对路径 + 双引号（Windows）或单引号（macOS/Linux）
- PowerShell 脚本中避免变量插值导致引号丢失：写成
code --install-extension "$extPath"，且确保$extPath本身已带引号 - Shell 脚本中用
for ext in *.vsix; do code --install-extension "$ext"; done，不裸写$ext
批量安装需逐个判断返回值，不能靠 sleep 硬等
code --install-extension 是同步命令，但某些扩展（如带 LSP server 的 Python、Rust）会在安装后触发后台解压或二进制下载 —— 此时 CLI 已退出，但扩展实际未就绪。单纯用 sleep 3 并不可靠。
实操建议：
- 每条安装命令后检查
$?（Shell）或$LASTEXITCODE（PowerShell），非 0 就中断或记录 - 安装完成后用
code --list-extensions | grep -i "ms-python"验证是否出现在列表里 - 对关键扩展（如
ms-python.python），可追加简单探测：code --status 2>/dev/null | grep -q "python"
离线环境必须加 --allow-unverified 参数
从外网下载的 .vsix 文件在内网首次安装时，VSCode 默认拒绝“未签名”来源，表现是命令无输出、无错误、但 code --list-extensions 查不到 —— 这不是路径或版本问题，而是签名校验被拦截。
实操建议：
- 所有离线安装命令末尾加上
--allow-unverified，例如：code --install-extension "python.vsix" --allow-unverified - 该参数仅影响本次安装，不改变全局设置，无需额外配置
security.workspace.trust.enabled - 若仍失败，检查 .vsix 是否损坏：用
unzip -t python.vsix验证 ZIP 完整性
脚本最易被忽略的点是：你以为它在装扩展，其实它卡在等 VSCode 退出；你以为路径没问题，其实空格让命令截断了一半；你以为装完了，其实签名拦在了最后一步。这些都不是“异常”，而是 VSCode CLI 的默认行为。
