过去在 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。
检查您的架构:
从 Anaconda 官方网站下载安装包:https://www.anaconda.com/download
图形化安装(.pkg)适用于 macOS
图形化安装程序是在 macOS 上安装 Anaconda 的最快方式,适合大多数用户。
验证安装包校验和
如果校验和不匹配,请重新下载,或在重新校验前移除 macOS 的隔离属性:
运行安装程序
双击 .pkg 文件。如有提示,请输入管理员凭据。
选择安装位置:
当出现提示时,允许安装程序运行 conda init。关闭安装程序,然后关闭并重新打开终端。
验证安装
如果一切正常,which conda 应该指向您的 Anaconda 文件夹,且 conda list 会列出大量包。
命令行安装(.sh)适用于 macOS
命令行安装程序可让您完全控制安装位置,适合脚本化或无界面环境。
验证校验和
运行安装程序
当询问安装路径时:
对 conda init 回答“yes”,然后关闭并重新打开终端。
验证安装
which conda conda info 技术支持
现代 macOS 默认使用 zsh,因此您的配置文件通常为 ~/.zshrc。
如果安装后仍缺少 conda,请手动初始化:
如果您使用 Bash:
请勿编辑或移除位于 /usr/bin 的系统自带 Python。
验证您的安装
快速检查以确认 Anaconda 与 Python 正常工作:
可选:确认 Jupyter 能运行:
创建并使用隔离环境
避免在 base 环境中工作。请为每个项目创建一个环境。
完成后停用环境:
优先使用 Conda 安装包(必要时再用 pip)
尽可能使用 conda 安装科学计算包。仅当 conda 无法获取该包时再使用 pip。
替代方案:Miniconda、Miniforge 与 Mambaforge
如果您希望占用更小空间,或需要在企业用途中合规的许可选项 ,可考虑以下方案:
Miniconda: 精简安装包(约 400 MB),仅包含 Python 与 conda。
Miniforge / Mambaforge: 社区安装器,默认使用 conda-forge(完全开源,无商业限制)。
Mambaforge 额外提供 mamba,依赖解析速度更快。
安装器:https://github.com/conda-forge/miniforge
常见问题与修复
conda: command not found技术支持
Apple Silicon 上的错误架构
如果输出为 x86_64,请卸载并重新安装 ARM64 构建。
Intel Mac 支持结束
自 2025 年年中起,新的 Intel(osx-64)构建不再维护。请使用存档安装包或 Miniforge/Miniconda。
安装程序无法写入 /opt
请重新运行安装程序,并将目标位置更改为您的主目录(例如 ~/anaconda3)。
Homebrew 安装
避免通过 Homebrew 安装 Anaconda——该方式已被废弃,且常导致 PATH 解析异常。请使用官方或社区安装器。
重复的 Anaconda 路径
编辑您的 Shell 配置文件并移除重复项:
Jupyter 无法打开
确保环境已激活,并且已在该环境中安装 jupyterlab:
不要移除系统自带的 Python
macOS 自带系统 Python。请保持不变。始终使用您 conda 环境中的 Python。
卸载或更新 Anaconda
安全更新:
清理与移除:
同时从 ~/.zshrc 或 ~/.bash_profile 中移除初始化相关行。
结语
在 macOS 上成功安装 Anaconda 主要取决于以下关键选择:
使用正确的架构(Apple Silicon 上为 ARM64)。
校验您的下载。
允许 conda init 并重启终端。
在面向项目的专用环境中工作。
遵守许可:企业或商业用途请使用 Miniforge 或 Miniconda。
按这些步骤操作,conda、Python 与 Jupyter 将表现稳定可控,您也能避免技术和许可上的陷阱。
过去在 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 架构,并从官方网站选择匹配的安装包。
osx-arm64)。它原生运行,性能最佳。osx-64)构建基本已停止维护。您可以使用存档安装包,或考虑改用 Miniforge/Miniconda。检查您的架构:
从 Anaconda 官方网站下载安装包:https://www.anaconda.com/download
图形化安装(.pkg)适用于 macOS
图形化安装程序是在 macOS 上安装 Anaconda 的最快方式,适合大多数用户。
验证安装包校验和
如果校验和不匹配,请重新下载,或在重新校验前移除 macOS 的隔离属性:
运行安装程序
双击
.pkg文件。如有提示,请输入管理员凭据。选择安装位置:
默认(无需 sudo):
/Users/<username>/anaconda3系统范围(需要 sudo):
/opt/anaconda3当出现提示时,允许安装程序运行
conda init。关闭安装程序,然后关闭并重新打开终端。验证安装
如果一切正常,
which conda应该指向您的 Anaconda 文件夹,且conda list会列出大量包。命令行安装(.sh)适用于 macOS
命令行安装程序可让您完全控制安装位置,适合脚本化或无界面环境。
验证校验和
运行安装程序
当询问安装路径时:
/opt/anaconda3进行系统范围安装(需要管理员权限),或~/anaconda3进行用户本地安装(无需管理员权限)。对
conda init回答“yes”,然后关闭并重新打开终端。验证安装
在您的 Shell 中初始化 Conda现代 macOS 默认使用
zsh,因此您的配置文件通常为~/.zshrc。如果安装后仍缺少
conda,请手动初始化:如果您使用 Bash:
请勿编辑或移除位于
/usr/bin的系统自带 Python。验证您的安装
快速检查以确认 Anaconda 与 Python 正常工作:
可选:确认 Jupyter 能运行:
创建并使用隔离环境
避免在 base 环境中工作。请为每个项目创建一个环境。
完成后停用环境:
优先使用 Conda 安装包(必要时再用 pip)
尽可能使用 conda 安装科学计算包。仅当 conda 无法获取该包时再使用 pip。
替代方案:Miniconda、Miniforge 与 Mambaforge
如果您希望占用更小空间,或需要在企业用途中合规的许可选项,可考虑以下方案:
conda-forge(完全开源,无商业限制)。mamba,依赖解析速度更快。安装器:https://github.com/conda-forge/miniforge
常见问题与修复
Apple Silicon 上的错误架构
如果输出为
x86_64,请卸载并重新安装 ARM64 构建。Intel Mac 支持结束
自 2025 年年中起,新的 Intel(
osx-64)构建不再维护。请使用存档安装包或 Miniforge/Miniconda。安装程序无法写入
/opt请重新运行安装程序,并将目标位置更改为您的主目录(例如
~/anaconda3)。Homebrew 安装
避免通过 Homebrew 安装 Anaconda——该方式已被废弃,且常导致 PATH 解析异常。请使用官方或社区安装器。
重复的 Anaconda 路径
编辑您的 Shell 配置文件并移除重复项:
Jupyter 无法打开
确保环境已激活,并且已在该环境中安装
jupyterlab:不要移除系统自带的 Python
macOS 自带系统 Python。请保持不变。始终使用您 conda 环境中的 Python。
卸载或更新 Anaconda
安全更新:
清理与移除:
同时从
~/.zshrc或~/.bash_profile中移除初始化相关行。结语
在 macOS 上成功安装 Anaconda 主要取决于以下关键选择:
conda init并重启终端。按这些步骤操作,
conda、Python 与 Jupyter 将表现稳定可控,您也能避免技术和许可上的陷阱。