直接安装官网darwin-universal版VS Code即可原生支持M1/M2/M3及Intel芯片;遇“未识别开发者”拦截时,Control+右键→“打开”即可绕过Gatekeeper,无需重装或降低系统安全性。

直接装官网最新 darwin-universal 版,拖进 /Applications 就能用;卡在“无法打开,因为来自未识别的开发者”?不是安装失败,是 macOS Gatekeeper 在拦你——绕过去就行,不用重装。
下载时选对包:universal 版本才真正兼容 M1/M2/M3 和 Intel
官网 https://code.visualstudio.com/Download 页面上,“macOS”按钮实际对应的是 darwin-universal 安装包(文件名类似 VSCode-darwin-universal.zip)。这个包同时包含 x86_64 和 arm64 二进制,无论你用的是 M 系列芯片还是老款 Intel Mac,它都能原生运行。别去第三方镜像站下,也别误点 “Insiders” 预览版——稳定开发就用 Stable 版。
常见错误现象:
• 下了 .dmg 却双击打不开(其实是压缩包,应为 .zip)
• 安装后启动闪退或字体模糊(用了仅限 Intel 的旧版)
• code --version 报错 Bad CPU type in executable(芯片架构不匹配)
首次启动被拦截?Control+右键 → “打开” 是最快解法
macOS 默认阻止非 App Store 应用,这不是病毒警告,只是系统策略。不需要改“隐私与安全性”里的全局设置,也不用执行 spctl 命令。
- 在 Finder 中定位到
/Applications/Visual Studio Code.app - 按住
Control键,单击图标,从右键菜单选“打开” - 弹窗里点“打开”,立刻生效,且只此一次
如果这步无效,再打开“系统设置 → 隐私与安全性 → 安全性”,在底部找“仍要打开”按钮点击确认。别勾选“允许从任何来源”,那会降低整机安全水位。
让 code 命令在终端里可用:优先走命令面板,别手写 ln -s
终端里敲 code . 打开当前项目,是日常高频操作。官方提供了一键注册方式,比手动建符号链接更可靠、更适配 zsh/bash 自动补全。
操作步骤:
• 启动 VS Code
• 按 Cmd + Shift + P 打开命令面板
• 输入 Shell Command: Install 'code' command in PATH 并回车
• 关闭并重开终端,运行 code --version 验证
为什么别用 sudo ln -s?
• /usr/local/bin 在 macOS Sequoia(15.x)后默认不可写,需额外关闭 SIP
• VS Code 更新后,/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code 路径不变,但硬链接可能失效
• 命令面板方式会自动写入 shell 配置(如 ~/.zshrc),重启终端即生效
中文界面没出来?语言包装了但没重启,或配置项被覆盖
装完 Chinese (Simplified) Language Pack for Visual Studio Code 后必须重启 VS Code,不是刷新窗口,是彻底退出再打开。如果仍显示英文,大概率是 settings.json 里有残留的 "locale": "en" 或其他 locale 设置覆盖了语言包逻辑。
快速修复:
• 按 Cmd + Shift + P,输入 Configure Display Language
• 选择 zh-cn,保存后 VS Code 会提示“需要重启窗口”
• 点击 Restart,不要点“Cancel”或关掉提示框
容易被忽略的点:
• 右键菜单、调试控制台、扩展详情页的语言,和主界面同步,但某些插件(如 Remote-SSH)有自己的 locale 设置,需单独检查
• 如果用多用户登录,语言设置存在用户级 settings.json,而非全局配置,切账户后可能回退英文



















