必须用arm64版本,装错x86_64会导致命令缓慢、包安装失败或conda不可用;需先运行uname -m确认架构,arm64才为原生环境,再通过curl下载arm64脚本静默安装并初始化zsh,最后关闭auto_activate_base、配置清华源、验证conda和python路径。

必须用 arm64 版本,装错 x86_64 会导致命令执行缓慢、部分包安装失败,甚至 conda: command not found。
确认芯片架构再动手
别凭直觉猜,直接在终端运行:uname -m。输出 arm64 才是 M1/M2/M3;如果看到 x86_64,说明当前终端正通过 Rosetta 运行,不是原生环境——这种情况下仍应安装 arm64 版本,但需先退出 Rosetta 终端(在“访达 → 应用程序 → 实用工具 → 终端”右键 → “显示简介”,取消勾选“使用 Rosetta 打开”)。
推荐用 shell 脚本安装(不依赖 GUI,路径可控)
GUI 的 .pkg 安装虽简单,但常因 Shell 初始化失败导致 conda 命令不可用;脚本方式更透明,也方便后续复现或批量部署。
- 下载安装脚本:
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh - 静默安装(不交互,避免误操作):
bash Miniconda3-latest-MacOSX-arm64.sh -b -p $HOME/miniconda3 - 初始化 shell 配置:
$HOME/miniconda3/bin/conda init zsh(macOS 默认是zsh) - 关掉终端,新开一个——此时提示符前应出现
(base)
如果跳过 conda init 直接 source $HOME/miniconda3/etc/profile.d/conda.sh,也能临时生效,但重启终端后失效。
装完立刻做三件事:关 auto_activate_base、配国内源、验证环境
默认每次开终端都进 base 环境,干扰日常命令(比如 python 指向 conda 的 Python 而非系统自带),且容易误装包到 base。
Miniconda py314_26.5.3-2 Linux x86_64 安装脚本,来自 Anaconda 官方 Miniconda 下载目录,适合服务器、工作站和容器环境配置轻量 Conda 与 Python。
- 关闭自动激活:
conda config --set auto_activate_base false - 加清华镜像(否则
conda install极慢或超时):conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/,再加conda-forge:conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ - 验证是否可用:
conda --version和conda list应正常返回,且which python在未激活任何环境时不应指向miniconda3目录
常见报错和对应解法
conda: command not found:90% 是没运行 conda init zsh 或没重启终端;剩下 10% 是用户 shell 不是 zsh(比如改过 fish),需对应执行 conda init fish。
ConnectionError: Failed to connect:没配镜像源,或配了但顺序不对——确保 pkgs/main 和 conda-forge 在最前,用 conda config --show channels 查看顺序。
安装包时报 PackageNotFoundError 且含 arm64 字样:说明该包还没提供 ARM 构建版本,可尝试加 -c conda-forge 强制从 conda-forge 安装,或改用 pip install(但注意混合使用 pip/conda 可能破坏环境一致性)。
真正容易被忽略的是:M1/M2 上某些科学计算包(如 tensorflow-macos、pytorch)有专用 channel,不能只靠默认源;它们的安装命令和 x86 平台完全不同,查文档时务必确认是否标注 arm64 兼容。










