必须装arm64原生版vscode，否则触发rosetta 2转译导致插件失败、终端错乱、调试卡死；需用file命令验证electron含arm64、process.arch返回arm64、活动监视器显示apple silicon，并确保shell、homebrew、扩展全为arm64架构。
必须装 ARM64 原生版 VSCode，否则所有后续配置都白搭——x86_64 版本哪怕能启动，也会触发 Rosetta 2 转译，导致插件加载失败、终端命令错乱、调试器卡死，甚至 process.arch 返回 x64。
确认当前 VSCode 是否为 arm64 架构
别信图标或官网下载记录，得用命令验证：
- 终端执行：
file /Applications/Visual\ Studio\ Code.app/Contents/MacOS/Electron，输出里必须含arm64字样才算原生 - 打开 VSCode →
Cmd+Shift+P→ 输入Developer: Toggle Developer Tools→ 控制台运行process.arch，返回值必须是"arm64" - 活动监视器里找
Code Helper (Renderer)进程，右侧“架构”列显示 Apple silicon 或 arm64，不是 Intel/x86_64
下载与安装 ARM64 原生版本（非 Universal）
官网页面的“Download for Mac”默认可能仍是 Universal 包，它会优先走 x86_64 路径。你必须手动选对：
scratch编程软件电脑版是一款非常受欢迎的编程学习软件，它适用于8-16岁的孩子编程学习，通过图形编程来培养孩子的编程思想，让孩子能够快速的掌握编程知识，感兴趣的朋友不要错过了，欢迎大家下载体验。基本简介Scratch编程软件利用图形化界面，把编程需要的基本技巧囊括其中，包括建模，控制，动画，事件，逻辑，运算，等等。孩子非常容易掌握，而内涵一点都不简单。通过这个工具平台，孩子可以快速掌握编程技巧，充分发挥自己的想象力。功能介绍1.体系化课程，学习目标明确；2.教学方法成熟，保证学习效率；3.老师在线答
- 访问
https://code.visualstudio.com/，点击下载按钮旁的下拉箭头，明确选择macOS (ARM64)（文件名通常含darwin-arm64） - 拖入
/Applications后，右键 VSCode 图标 → “显示简介”，确保“以 Rosetta 模式打开”未勾选 - 如果已装过旧版，先
killall "Code Helper"杀掉后台进程，再从 Finder 双击启动，避免残留转译态
终端与 Shell 必须同为 arm64 上下文
VSCode 集成终端若调用 x86_64 的 zsh 或 node，扩展和构建工具仍会降级或报错：
- 在 VSCode 终端中运行：
uname -m，结果必须是arm64；若为x86_64，说明终端本身在 Rosetta 下运行 - 检查默认 shell：
echo $SHELL，应为/bin/zsh（系统原生），而非/opt/homebrew/bin/zsh（若该 zsh 是通过 Intel Homebrew 安装的，就危险了） - Homebrew 必须重装 ARM64 版：卸载旧版
/usr/local/bin/brew后，用官方脚本装到/opt/homebrew，否则which node、which python3返回的路径大概率是 x86_64 二进制
扩展必须匹配 arm64 ABI，不能靠“自动兼容”
很多扩展（如 C/C++、Python、LaTeX Workshop）含本地编译模块，x86_64 扩展在 arm64 VSCode 中直接被禁用，且不会提示具体原因：
- 打开扩展面板（
Cmd+Shift+X），对每个关键扩展点击齿轮 → “卸载”，然后重新搜索安装——只认发布日期晚于 2022 年 10 月、或详情页标注支持 Apple silicon 的版本 - 在
settings.json中加一行："extensions.ignoreRecommendations": true，防止 VSCode 自动推荐 x86_64 专属扩展 - 遇到“Unsupported architecture”警告时，不要点“启用”，而是去扩展设置里找
Enable for Apple silicon开关（如有），或切换到 Web 版替代项（如某些 LSP 客户端提供 WebAssembly 后备）
最容易被忽略的是 Homebrew 和 Shell 的隐性架构错配：你以为装了 arm64 VSCode，但终端里 node -v 调用的仍是 Rosetta 下的 Node.js，pdflatex 找不到路径，clang++ 报 include 错误……这些都不是 VSCode 本身的问题，而是整个工具链没对齐。每一步都要用 file、uname -m、process.arch 交叉验证，少一个环节，后面全崩。
