必须分三步：先装code命令，再装扩展，最后覆盖配置；macOS装完即用，Windows需启动VSCode写入PATH，Linux首次调用需加--no-sandbox --disable-gpu参数；批量装扩展须检查退出码、按依赖分组、逐组验证安装结果。
能，但必须分三步走：先装code命令，再装扩展，最后覆盖配置。任何跳过系统探测或忽略code命令就绪状态的脚本，运行必失败。
如何让code命令在安装后立即可用
很多脚本卡在“找不到code命令”上，不是因为没装VSCode，而是没等它注册进PATH。macOS用Homebrew装完brew install --cask visual-studio-code后，code命令默认就绪；但Windows用winget install -e --id Microsoft.VisualStudioCode后，需要额外调用Start-Process启动一次VSCode并关闭，才能触发环境变量写入；Linux（如Ubuntu）用APT安装后，code命令虽存在，但首次运行会弹GUI提示，需加--no-sandbox --disable-gpu参数静默初始化。
- macOS：装完即可用，无需额外操作
- Windows：执行
code --version前，先运行Start-Process code -ArgumentList "--no-sandbox" -WindowStyle Hidden并等待3秒 - Linux：首次调用
code --install-extension时，务必加--no-sandbox --disable-gpu，否则进程挂起
批量安装扩展时为什么总漏装或报错
常见错误是直接循环跑code --install-extension却不检查退出码，而VSCode扩展安装失败时返回值不为0，但脚本继续往下跑，导致后续扩展全跳过。更隐蔽的问题是：某些扩展（如ms-python.python）依赖Python解释器已存在，若脚本在装Python前就装它，会静默失败；还有些扩展（如bradlc.vscode-tailwindcss）需要VSCode重启才生效，但脚本里没做等待或重试机制。
- 每次
code --install-extension后必须检查$?（Bash）或$LASTEXITCODE（PowerShell），非0则sleep 2秒后重试，最多3次 - 把扩展按依赖关系分组：基础语言支持（如
ms-python.python）放第一组，工具类（如esbenp.prettier-vscode）放第二组，UI增强类（如oderwat.indent-rainbow）放第三组 - 每组安装完后执行
code --list-extensions | grep "扩展ID"确认是否真装上了，别信输出日志
settings.json自动部署容易被忽略的路径细节
用户级settings.json路径不是固定的：~/.config/Code/User/settings.json只适用于Linux；macOS是~/Library/Application Support/Code/User/settings.json；Windows是%APPDATA%\Code\User\settings.json。更麻烦的是，如果VSCode从未启动过，这个目录可能根本不存在，直接cp会失败。另外，硬覆盖settings.json会清掉用户原有设置，应改用jq合并——但Windows默认没jq，得提前判断并降级为文本追加。
- 先用
code --user-data-dir获取实际用户数据目录（VSCode 1.85+支持），比硬编码路径可靠 - 若该目录下
settings.json不存在，先mkdir -p再写入；若存在，用jq '. += $ARGS.positional[0]' settings.json --argfile new ./my-settings.json > tmp.json合并（Linux/macOS） - Windows PowerShell中无
jq时，改用Get-Content settings.json | ConvertFrom-Json+ConvertTo-Json -Depth 10手动合并，避免破坏JSON结构
真正难的不是写脚本，而是处理那些“装完了但没生效”的灰色状态：比如扩展列表里有名字却不起作用，或者settings.json写了但缩进没变。这些都得靠code --status查进程状态、code --list-extensions --show-versions核对版本、甚至临时启一个code --inspect-extensions来调试。自动化不是一劳永逸，而是把最常崩的点，变成可验证、可重试、可日志追踪的动作。
