code命令不可用的根本原因是未注册到系统PATH，必须通过VS Code图形界面执行“Shell Command: Install 'code' command in PATH”并重启终端验证；不同安装方式（如winget、Homebrew、APT）初始化行为各异，统一验证方式为运行code --version。
code 命令没注册进 PATH，脚本就必然失败——不是 VSCode 没装，而是它没“活过来”。
code 命令为什么装完还不可用
VSCode 安装器本身不保证 code 命令立即可用。不同系统初始化机制差异极大：
- macOS 用 Homebrew 装完
brew install --cask visual-studio-code，code默认就绪 - Windows 用
winget install -e --id Microsoft.VisualStudioCode后，必须手动启动一次 VSCode（哪怕只开半秒），它才会把自身写入系统 PATH - Linux（如 Ubuntu）APT 安装后
code命令虽存在，但首次调用会弹 GUI 初始化窗口；不加--no-sandbox --disable-gpu就卡住，脚本直接 hang 住
验证方式统一：运行 code --version。失败？别急着重装，先按系统补这一步。
批量装扩展时怎么避免漏装和静默失败
code --install-extension 不是“发个请求就完事”，它返回非零退出码就代表失败，而默认脚本根本不检查。
- 每次执行后必须查
$?（Bash）或$LASTEXITCODE（PowerShell），非 0 就 sleep 2 秒后重试，最多 3 次 - 扩展有依赖顺序：比如
ms-python.python要求系统已装 Python，bradlc.vscode-tailwindcss需 VSCode 重启才生效——不能全塞进一个 for 循环里硬跑 - 推荐分三组安装：
基础语言支持→构建/格式化工具→UI 增强类，每组末尾用code --list-extensions | grep "ms-python.python"确认真装上了
tasks.json 为什么配置完还是不显示任务
VSCode 只认工作区根目录下的 .vscode/tasks.json，路径错一丁点就失效。
- 文件名必须是
tasks.json，不是task.json或Tasks.json - 必须放在你用「File → Open Folder」打开的那个文件夹下，不能在子目录（如
src/.vscode/）或家目录 -
version字段必须是字符串"2.0.0"，写成2.0或删掉都会让整个文件被忽略 - 如果打开的是单个文件（没用文件夹模式），
.vscode/下所有配置全不加载
离线环境怎么批量部署 .vsix 扩展
企业内网或 CI 构建机常无外网，.vsix 是唯一可靠方案。
-
code --install-extension支持本地路径，直接传./extensions/ms-python-2024.8.0.vsix即可 - 批量脚本别用
for file in *.vsix这种裸循环——文件名带空格或特殊字符会崩；改用find . -name "*.vsix" -print0 | while IFS= read -r -d '' file; do code --install-extension "$file"; done - 注意：.vsix 文件必须是对应 VSCode 版本编译的，VSCode 1.93 装 1.90 的 .vsix 可能报错
Extension is not compatible
最易被忽略的一点：所有自动化操作都依赖 VSCode 是否真正完成初始化——哪怕只差一次 GUI 启动、一次 --no-sandbox 静默运行，code 命令就只是个摆设。
