跳至主要内容

在 macOS 上安装 Anaconda(2026):Apple Silicon、conda init 与常见问题修复

一份实用指南,帮助您在原生 ARM64 的 Mac 上安装 Anaconda,校验下载、初始化 conda,并设置干净的环境。
· 7分钟 阅读

使用 AI 探索

过去在 Mac 上安装 Anaconda 十分简单:下载、点击、完成。如今,由于架构差异(Apple Silicon 与旧款 Intel)、Shell 初始化和 PATH 冲突,您很容易遇到 “conda: command not found”、在 Rosetta 下运行的缓慢 Intel 构建,或始终无法启动的 Jupyter。

我通过一个简明清单来规避这些问题:选择正确的安装包、校验校验和、允许安装程序运行 conda init、重启终端,并用一个全新的环境进行测试。以下步骤基于当前 macOS 版本(Sonoma 14 与 Sequoia 15)的一贯可行做法。

什么是 Anaconda?

Anaconda 是一个 Python 发行版,打包了 Python 和数百个科学计算包(NumPy、pandas、SciPy、scikit-learn 等)。它包含 conda 包与环境管理器,便于安装预编译包并隔离项目依赖。

重要许可说明(2026 更新)

自 2025 年 7 月起,免费的Anaconda Individual Edition 支持个人、教育机构、非营利组织,以及员工或合同工不超过 200 人的营利性组织使用。员工或合同工超过 200 人的组织,须根据 Anaconda 的条款购买 Business(或 Enterprise)许可。

详情请参阅当前的 Anaconda 服务条款。

为您的 Mac 选择合适的安装包

在下载之前,先确认您的 Mac 架构,并从官方网站选择匹配的安装包。

  • Apple Silicon(M1/M2/M3): 使用 macOS ARM64 构建(osx-arm64)。它原生运行,性能最佳。
  • Intel Mac: 自 2025 年年中起,新的 Intel(osx-64)构建基本已停止维护。您可以使用存档安装包,或考虑改用 Miniforge/Miniconda。

检查您的架构:

uname -m # prints 'arm64' on Apple Silicon, 'x86_64' on Intel

从 Anaconda 官方网站下载安装包:https://www.anaconda.com/download

图形化安装(.pkg)适用于 macOS

图形化安装程序是在 macOS 上安装 Anaconda 的最快方式,适合大多数用户。

验证安装包校验和

shasum -a 256 ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.pkg

如果校验和不匹配,请重新下载,或在重新校验前移除 macOS 的隔离属性:

xattr -dr com.apple.quarantine ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.pkg

运行安装程序

双击 .pkg 文件。如有提示,请输入管理员凭据。

选择安装位置:

  • 默认(无需 sudo): /Users/<username>/anaconda3

  • 系统范围(需要 sudo): /opt/anaconda3

当出现提示时,允许安装程序运行 conda init。关闭安装程序,然后关闭并重新打开终端。

验证安装

which conda conda list | head python3 --version

如果一切正常,which conda 应该指向您的 Anaconda 文件夹,且 conda list 会列出大量包。

命令行安装(.sh)适用于 macOS

命令行安装程序可让您完全控制安装位置,适合脚本化或无界面环境。

验证校验和

shasum -a 256 ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.sh

运行安装程序

cd ~/Downloads bash Anaconda3-2025.06-0-MacOSX-arm64.sh

当询问安装路径时:

  • /opt/anaconda3 进行系统范围安装(需要管理员权限),或

  • ~/anaconda3 进行用户本地安装(无需管理员权限)。

对 conda init 回答“yes”,然后关闭并重新打开终端。

验证安装

which conda conda info 
在您的 Shell 中初始化 Conda

现代 macOS 默认使用 zsh,因此您的配置文件通常为 ~/.zshrc。

如果安装后仍缺少 conda,请手动初始化:

echo $SHELL # should print /bin/zsh conda init zsh # Then close and reopen Terminal which conda

如果您使用 Bash:

conda init bash

请勿编辑或移除位于 /usr/bin 的系统自带 Python。

验证您的安装

快速检查以确认 Anaconda 与 Python 正常工作:

conda list | head python3 --version which python3 python3 -c "import sys; print(sys.executable)"

可选:确认 Jupyter 能运行:

jupyter lab # or: jupyter notebook

创建并使用隔离环境

避免在 base 环境中工作。请为每个项目创建一个环境。

# Create a new environment
conda create -n analytics-env python=3.11 -y

# Activate the environment
conda activate analytics-env

# Install common libraries
conda install numpy pandas -y

# Verify installation
python3 -c "import numpy as np, pandas as pd; print(np.__version__, pd.__version__)"

完成后停用环境:

conda deactivate

优先使用 Conda 安装包(必要时再用 pip)

尽可能使用 conda 安装科学计算包。仅当 conda 无法获取该包时再使用 pip。

# conda-first approach
conda install scikit-learn

# fallback to pip (if the package isn't available via conda)
pip install package-name

替代方案:Miniconda、Miniforge 与 Mambaforge

如果您希望占用更小空间,或需要在企业用途中合规的许可选项,可考虑以下方案:

  • Miniconda: 精简安装包(约 400 MB),仅包含 Python 与 conda。
  • Miniforge / Mambaforge: 社区安装器,默认使用 conda-forge(完全开源,无商业限制)。
  • Mambaforge 额外提供 mamba,依赖解析速度更快。

安装器:https://github.com/conda-forge/miniforge

常见问题与修复

conda: command not found
conda init zsh 
# close and reopen Terminal which conda

Apple Silicon 上的错误架构

# Check system architecture (hardware)
uname -m

# Check Python interpreter architecture
python3 -c "import platform; print(platform.machine())"

如果输出为 x86_64,请卸载并重新安装 ARM64 构建。

Intel Mac 支持结束

自 2025 年年中起,新的 Intel(osx-64)构建不再维护。请使用存档安装包或 Miniforge/Miniconda。

安装程序无法写入 /opt

请重新运行安装程序,并将目标位置更改为您的主目录(例如 ~/anaconda3)。

Homebrew 安装

避免通过 Homebrew 安装 Anaconda——该方式已被废弃,且常导致 PATH 解析异常。请使用官方或社区安装器。

重复的 Anaconda 路径

编辑您的 Shell 配置文件并移除重复项:

# Open your shell profile for editing
nano ~/.zshrc    # or: nano ~/.bash_profile

# (Inside the file) remove extra PATH entries for older Anaconda installs
# Then save and exit (Ctrl+O, Enter, Ctrl+X)

# Reload your updated profile
source ~/.zshrc

# Verify that conda is now pointing to the correct path
which conda

Jupyter 无法打开

确保环境已激活,并且已在该环境中安装 jupyterlab:

# Activate your environment
conda activate analytics-env

# Install JupyterLab inside the environment
conda install jupyterlab -y

# Launch JupyterLab
jupyter lab

不要移除系统自带的 Python

macOS 自带系统 Python。请保持不变。始终使用您 conda 环境中的 Python。

卸载或更新 Anaconda

安全更新:

# Update conda itself
conda update conda

# (Optional) Update all packages in the current environment — use cautiously
conda update --all

清理与移除:

# Install the Anaconda cleanup utility
conda install anaconda-clean -y

# Run the cleanup tool (removes configs, cache, and settings)
anaconda-clean --yes

# Manually delete the Anaconda installation directory
# (Use caution — this permanently removes the files)
rm -rf ~/anaconda3   # or: sudo rm -rf /opt/anaconda3

同时从 ~/.zshrc 或 ~/.bash_profile 中移除初始化相关行。

结语

在 macOS 上成功安装 Anaconda 主要取决于以下关键选择:

  • 使用正确的架构(Apple Silicon 上为 ARM64)。
  • 校验您的下载。
  • 允许 conda init 并重启终端。
  • 在面向项目的专用环境中工作。
  • 遵守许可:企业或商业用途请使用 Miniforge 或 Miniconda。

按这些步骤操作,conda、Python 与 Jupyter 将表现稳定可控,您也能避免技术和许可上的陷阱。

主题