必须装arm64原生版vscode，否则触发rosetta2转译导致插件禁用、终端错乱、调试卡死；需三步验证：file命令查electron含arm64、process.arch返回arm64、活动监视器中code helper架构为apple silicon。
必须装 ARM64 原生版 VSCode，否则所有后续配置都白搭——x86_64 版本哪怕能启动，也会触发 Rosetta 2 转译，导致插件加载失败、终端命令错乱、调试器卡死，甚至 process.arch 返回 x64。
怎么确认当前 VSCode 是 arm64 原生版
别信图标、下载记录或“看起来很新”，得用三处硬指标交叉验证：
- 终端执行
file /Applications/Visual\ Studio\ Code.app/Contents/MacOS/Electron，输出里必须含arm64字样（出现x86_64就是假原生） - VSCode 内按
Cmd+Shift+P→ 输入Developer: Toggle Developer Tools→ 控制台运行process.arch，返回值必须是"arm64" - 打开“活动监视器”，搜索
Code Helper (Renderer)，右侧“架构”列必须显示Apple silicon或arm64，不是Intel
三者缺一不可。常见错误是只看活动监视器里主进程显示 Apple silicon，却忽略 Renderer 进程仍为 x86_64 —— 那说明扩展层仍在转译。
为什么不能用 Universal 版或官网默认下载链接
官网“Download for Mac”按钮默认可能跳转到 Universal 包（含 x86_64 + arm64），但 macOS 会优先加载 x86_64 架构，导致整个 Electron 进程走 Rosetta 2。这不是 bug，是 macOS 的默认行为。
PyCharm 2026.2.0.1 Mac版
下载
PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合在macOS系统上进行 Python 项目开发、运行、调试和测试。
- 必须手动点击标有
ARM64或Apple Silicon的独立下载项（文件名通常含darwin-arm64） - 安装后右键 Dock 中的 VSCode 图标 → “显示简介”，确保“以 Rosetta 模式打开”**未勾选**
- 已装旧版？先在终端运行
killall "Code Helper"清掉后台残留进程，再从 Finder 双击启动新版本，避免缓存劫持
终端、Homebrew、Python 全链路必须 arm64 对齐
VSCode 本体是 arm64，但集成终端若调用 x86_64 的 zsh 或 python3，扩展和构建工具照样降级或报错。
- VSCode 终端中运行
uname -m，结果必须是arm64；若为x86_64，说明终端本身在 Rosetta 下运行 - 检查默认 shell：
echo $SHELL应返回/bin/zsh（系统原生）或/opt/homebrew/bin/zsh（ARM64 Homebrew 安装的 zsh），不能是/usr/local/bin/zsh（那是 Intel Homebrew 装的） -
which brew必须是/opt/homebrew/bin/brew；若为/usr/local/bin/brew，说明 Homebrew 是 Intel 版，需卸载后重装 ARM64 版 - 验证 Python：
python3 -c "import platform; print(platform.machine())"输出必须是arm64；which python3应指向/opt/homebrew/bin/python3
扩展与渲染层容易被忽略的坑
很多扩展（如 C/C++、Python、LaTeX Workshop）含本地编译模块，x86_64 扩展在 arm64 VSCode 中会被静默禁用，且不提示具体原因。
- 打开扩展面板（
Cmd+Shift+X），对每个关键扩展点击齿轮 → “卸载”，然后重新搜索安装——只认发布日期晚于 2022 年 10 月、或详情页明确标注支持 Apple silicon 的版本 - 在
settings.json中加一行："extensions.ignoreRecommendations": true，防止 VSCode 自动推荐 x86_64 专属扩展 - 图形卡顿？在设置 JSON 中添加：
"disable-hardware-acceleration": true和"enable-metal": true，M 系列芯片用 Metal 渲染比 OpenGL 更稳
最常被跳过的动作：重装扩展前没卸载旧版，导致缓存残留；以及没关掉“自动推荐”，让 VSCode 在后台悄悄装回 x86_64 插件。这两步一漏，前面所有架构验证都白做。
