正确命令是brew install --cask visual-studio-code；VS Code属GUI应用，必须用--cask选项，仅brew install visual-studio-code会报错。安装后需在VS Code中启用Shell Command以支持终端code命令。
brew install --cask visual-studio-code 是唯一正确命令
Mac 上用 Homebrew 安装 VS Code，必须用 --cask 选项，不能只写 brew install visual-studio-code。后者会报错 Error: No available formula or cask with the name "visual-studio-code"，因为 VS Code 是图形界面应用，属于 Cask 而非 Formulae。
执行前需确认 Homebrew 已就绪：brew --version 有输出、brew doctor 显示 Your system is ready to brew.。若未安装，请先运行官方脚本：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，并确保已装 Xcode 命令行工具（xcode-select --install）。
安装后 code 命令不可用？检查 PATH 和 shell 配置
安装完成不代表终端能直接敲 code . 打开当前文件夹——这是最常被忽略的一步。Homebrew Cask 本身不自动把 code 可执行文件加入 PATH，需要手动启用 Shell Command。
打开 VS Code → Command Palette（Cmd+Shift+P）→ 输入 Shell Command: Install 'code' command in PATH → 回车执行。该操作会向你的 shell 配置文件（~/.zshrc 或 ~/.bash_profile）追加一行 export，并重载配置。
验证是否生效：which code 应输出类似 /usr/local/bin/code；code --version 应返回版本号。若仍报 command not found，检查你用的是哪个 shell（echo $SHELL），并确认对应配置文件是否被正确 source 过。
安装路径和更新机制与普通命令行工具不同
VS Code 通过 Cask 安装，默认位置是 /opt/homebrew-cask/Caskroom/visual-studio-code/（Apple Silicon）或 /usr/local/Caskroom/visual-studio-code/（Intel），不是 /usr/local/bin 下的软链。这意味着：
-
brew upgrade不会升级 VS Code —— 必须用brew upgrade --cask visual-studio-code -
brew uninstall visual-studio-code会失败，正确命令是brew uninstall --cask visual-studio-code - 每次更新后，
code命令仍可用，但需重启已打开的终端窗口才能识别新版本的二进制路径（尤其在自动更新后）
卸载残留可能影响重装，别跳过清理步骤
如果之前用官网 dmg 包装过 VS Code，又改用 Homebrew 安装，容易出现冲突：菜单栏图标重复、code 命令指向旧路径、扩展同步异常等。
彻底卸载旧版再装 Homebrew 版的建议流程：
- 拖 VS Code.app 到废纸篓（从“应用程序”文件夹）
- 删配置目录：
rm -rf ~/Library/Application\ Support/Code - 删缓存：
rm -rf ~/Library/Caches/com.microsoft.VSCode - 删偏好设置：
rm -rf ~/Library/Preferences/com.microsoft.VSCode.helper.plist - 最后执行：
brew install --cask visual-studio-code
Homebrew 安装的 VS Code 启动时不会弹“无法验证开发者”警告，这点比官网 dmg 包更省心，但前提是系统没残留旧签名数据。
