必须确保arch和python3 -c "import platform; print(platform.machine())"均输出arm64，否则科学计算包将因架构错配而报“no matching distribution”或编译失败；需禁用Rosetta、清理x86_64残留（如/usr/local/bin/python3、~/.pyenv）、选用Homebrew或Miniforge安装arm64原生Python，并验证sys.base_prefix路径及IDE解释器配置一致。
platform.machine() 必须输出 arm64，否则所有后续安装的科学计算、深度学习包都会卡在 “no matching distribution” 或编译失败——这不是 pip 配置问题，是底层架构错配。
确认终端和 Python 是否真为 arm64
很多人以为打开终端就是原生环境，其实可能被 Rosetta 暗中接管。必须分两步验证：
- 运行
arch，输出应为arm64 - 再运行
python3 -c "import platform; print(platform.machine())"，也必须是arm64
如果任一为 x86_64：右键“终端”App → “显示简介” → 取消勾选“使用Rosetta打开”，然后重启终端。别信 python3 --version，它不暴露架构。
禁用系统自带和 Intel 混装 Python
/usr/bin/python3 是只读、老旧、非 arm64 的系统版本，不能用于开发；/usr/local/bin/python3 很大概率是旧版 Homebrew（Intel 版）或 pyenv 编译残留，必须清理。
- 先查路径：
which python3，如果不是/opt/homebrew/bin/python3或~/miniforge3/bin/python3，就说明当前环境不可靠 - 若之前用过
pyenv，直接删掉整个~/.pyenv目录，避免残留 x86_64 解释器干扰 - 卸载 Anaconda：
brew uninstall --cask anaconda，不要试图用conda config补救，默认 channel 已污染 solver 状态
推荐两种安装方式：Homebrew vs Miniforge
二者都提供 arm64 二进制，但适用场景不同，选错会导致后续包管理崩溃：
立即学习“Python免费学习笔记（深入）”；
-
Homebrew（轻量开发/脚本/工具链）：确保已装 Apple Silicon 版 Homebrew（路径为
/opt/homebrew），再执行brew install python；验证python3 -c "import sys; print(sys.base_prefix)"应输出类似/opt/homebrew/opt/python@3.12/Frameworks/Python.framework/Versions/3.12 -
Miniforge（数据科学/深度学习）：专为
conda-forge+osx-arm64设计，避免 solver 卡死；下载并安装：curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-arm64.sh"→bash Miniforge3-MacOSX-arm64.sh；安装后运行conda info --subdir，输出必须是osx-arm64
别用 pyenv 默认配置或 Anaconda 官方包——它们默认 fallback 到 osx-64，极易触发降级或 solver 爆炸。
升级 pip 和验证 wheel 架构匹配
即使 Python 是 arm64，老版本 pip 仍可能忽略 macosx_arm64 标签，导致找不到 wheel：
- 必须用
python3 -m pip install -U pip升级，而非pip install -U pip（后者可能调用缓存的 x86_64 pip 二进制） - 安装包时报 “no matching distribution”，先检查该包是否已发布
arm64wheel：pip index versions numpy（或访问 PyPI 页面看 wheel 文件名是否含macosx_12_0_arm64） - 若确实没有，再加
--no-binary :all:强制源码编译，例如：pip install --no-binary numpy numpy
最常被忽略的一点：IDE（如 VS Code、PyCharm）里的 Python 解释器路径必须指向 /opt/homebrew/bin/python3 或 ~/miniforge3/bin/python3，且 base_prefix 要与终端一致——否则调试时架构又悄悄切回 x86_64。
