Mac 系统下 Python 环境安装与配置指南(Anaconda)
软件及环境介绍
- 安装环境:macOS
- 软件名称:Anaconda Distribution
- 版本选择:为适配更多科学计算环境,推荐选择 Intel 芯片对应的最新版本。若使用 Apple Silicon (M1/M2) 芯片,建议确认是否支持 ARM64 架构或选择通用版本。
下载渠道
- 官方最新版:访问 Anaconda 官网下载 Python 3.11 及以上版本。
- 历史版本:可通过官网 Archive 页面获取旧版安装包。
- 国内镜像:推荐使用清华大学开源软件镜像站,下载速度更快且稳定。
注意:国内用户优先选择清华镜像源,可显著减少等待时间。
安装步骤
1. 下载安装包
访问下载页面,获取 .pkg 格式的安装文件。建议选择较为稳定的 Python 3.9 或 3.11 版本。
2. 开始安装
双击下载的 .pkg 文件,系统可能会提示安全警告,点击'允许'以继续。
3. 许可协议
阅读并同意最终用户许可协议(EULA),点击'继续'。
4. 安装位置选择
通常情况下,无需更改默认安装路径,直接点击'安装'即可。如果安装程序跳过目标选择页面导致失败,请在'安装类型'页面上点击'更改安装位置',选择'仅为我安装'或指定非系统目录。
注意事项:避免将 Anaconda 安装在
/usr/local等系统目录下,以免权限冲突。
5. 完成安装
等待进度条走完,点击'关闭'结束安装过程。安装成功后,系统会自动弹出 Anaconda Navigator 界面,或者可以在应用程序文件夹中找到它。
验证安装
打开终端(Terminal),输入以下命令检查安装情况:
python --version
输出应显示类似 Python 3.x.x 的版本信息。
同时检查 Conda 是否可用:
conda --version
若显示版本号,说明环境配置成功。
运行 Python 开发环境
安装完 Anaconda 后,后续操作变得十分便利。以下以 Jupyter Notebook 为例进行说明。
Jupyter Notebook 简介
Jupyter Notebook 是一个交互式笔记本,支持运行多种编程语言(如 Julia, Python, R)。它此前被称为 IPython notebook,非常适合数据分析和机器学习入门。
启动方法
虽然可以通过 Anaconda-Navigator 点击 Launch 打开,但为了更快捷方便,推荐使用命令行方式:
- 打开 Mac 电脑上的终端。
- 输入以下命令并按回车键:
jupyter notebook - 浏览器会自动打开一个本地地址(通常是
http://localhost:8888),并显示文件列表。 - 点击'新建'创建新的 Notebook。
- 在单元格中编写代码,按下
Shift + Enter运行。
退出服务
如需退出并关闭 Jupyter Notebook,先关闭浏览器标签页,再回到终端窗口,按下 Ctrl + C 停止服务进程。
Conda 环境管理
Anaconda 自带 Conda 包管理器,建议为不同项目创建独立的环境,以避免依赖冲突。
创建新环境
创建一个名为 myproject 的 Python 3.9 环境:
conda create -n myproject python=3.9
激活环境
conda activate myproject
激活后,终端左侧会显示 (myproject) 标识。
退出环境
conda deactivate
查看环境列表
conda env list
删除环境
conda remove -n myproject --all
常见问题排查
1. 权限问题
如果在安装或运行时报错 Permission denied,请尝试修改文件权限或使用 sudo 命令(谨慎使用)。
2. 环境变量未生效
如果安装了 Anaconda 但终端无法识别 conda 命令,可能需要重新加载配置文件。编辑 ~/.zshrc 或 ~/.bash_profile,确保包含 Anaconda 初始化代码:
export PATH="/Users/你的用户名/anaconda3/bin:$PATH"
然后执行 source ~/.zshrc 使配置生效。
卸载指南
相较于 Windows 系统,macOS 系统安装 Anaconda 过程中出现问题的概率相对较低。但如果需要卸载重装,请参考以下步骤:
- 打开 Terminal。
- 删除整个 Anaconda 文件夹,通常位于主目录下或
/opt目录下:rm -rf ~/anaconda3 - 删除所有隐藏文件和文件夹,这些文件可能未被上述命令删除,它们位于主目录下:
rm -rf ~/.condarc rm -rf ~/.continuum rm -rf .anaconda - 打开用户的 shell 配置文件(
.bash_profile,.bashrc或.zshrc),删除所有与 anaconda 相关的路径或环境变量。 - 最后,打开一个新的 Terminal 窗口以使这些改变生效。
总结
本文详细介绍了在 macOS 系统下通过 Anaconda 安装 Python 环境的完整流程,包括安装、验证、环境管理及卸载步骤。Anaconda 提供了丰富的预装科学计算库,是数据科学和机器学习领域的理想起点。掌握基础的环境配置能力,有助于后续更高效地开展编程工作。


