直接下载官网vs code .zip包拖入applications即可使用，需选对芯片版本；首次启动须右键“打开”绕过macos安全限制；终端用code命令需手动配置shell command并重启终端。
直接下载官方 .zip 包，拖进 Applications 文件夹即可用，不用安装程序，也不需要管理员权限。
下载时选对芯片版本（M 系列 / Intel）
官网会自动识别系统，但手动确认更稳妥：
- 点击左上角苹果图标 →「关于本机」→ 查看「芯片」：Apple Silicon（M1/M2/M3/M4）选
Universal版本；Intel 芯片选Intel版本 - 下载地址始终认准官网：
https://code.visualstudio.com/Download，别点第三方镜像或“高速下载”按钮 - 文件名示例：
VSCode-darwin-universal.dmg（通用版）或VSCode-darwin-arm64.dmg（仅 M 系列）
首次启动被拦？绕过 macOS 安全限制
macOS 默认阻止未签名应用运行，VS Code 是合法签名的，但有时仍弹窗提示“已损坏”或“无法验证开发者”：
- 不要双击打开 .dmg 后直接运行
Visual Studio Code.app - 先把它拖进
/Applications文件夹（完成复制） - 然后在「访达」中右键
Visual Studio Code.app→「打开」→ 点「打开」确认 - 后续启动就不再拦截，可直接双击
终端里想用 code 命令？必须手动配置
Windows/macOS/Linux 官方安装包默认不加 code 到 PATH，Mac 上尤其容易漏这步：
- 启动 VS Code → 打开命令面板（
Cmd+Shift+P）→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 关闭并重启终端，再试
code --version或code . - 如果报
command not found，说明没成功：检查是否用了 zsh（macOS 默认），确认~/.zshrc里有对应 PATH 行，必要时手动加export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
真正卡住的点往往不是下载或拖动，而是第一次右键「打开」那一下，以及 code 命令没配好导致后续所有 CLI 流程断掉——这两个动作不做，后面装插件、跑调试、集成 Git 都会莫名失效。
