Mac用户应优先用Homebrew安装Python 3,因其独立于系统、自动配置pip3和venv且避免权限问题;其次可选官网.pkg安装包或pyenv多版本管理,再通过venv创建虚拟环境隔离依赖,最后用终端、Python Launcher或Automator运行脚本。

如果您刚入手一台Mac电脑,希望开始Python开发,但系统自带的Python版本为2.7或完全未预装Python,且无法直接运行.py脚本,则可能是由于系统默认Python受保护、PATH未正确配置、缺少pip或venv模块所致。以下是完成Mac上Python安装、环境配置及脚本运行的多种可行方法:
一、使用Homebrew安装独立Python运行时
Homebrew是macOS最主流的包管理器,所安装的Python完全独立于系统路径,自动配置pip3、python3命令及venv模块,避免权限错误与PATH冲突,适合绝大多数用户。
1、打开“终端”应用,执行命令安装Homebrew(若尚未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、安装完成后,运行brew update更新软件包索引。
立即学习“Python免费学习笔记(深入)”;
3、执行brew install python安装最新稳定版Python 3(含pip3、python3可执行文件及venv模块)。
4、验证安装:输入python3 --version和pip3 --version,确认输出有效版本号;再运行which python3,返回路径应为/opt/homebrew/bin/python3(Apple Silicon)或/usr/local/bin/python3(Intel),而非/usr/bin/python3。
二、通过官方.pkg安装包安装Python3
该方式不依赖第三方工具,适用于离线环境、需指定小版本(如Python 3.11)或偏好图形化流程的用户;安装包自带IDLE、Python Launcher及pip3,开箱即用。
1、访问Python官网下载页面:https://www.python.org/downloads/macos/,根据芯片类型选择对应安装包:Apple Silicon机型选标有“ARM64”或“Universal2”的pkg;Intel机型选“Intel64”版本。
2、双击下载的.pkg文件,按向导提示操作;在“安装类型”页中,务必勾选“Add Python to PATH”选项。
3、安装结束后,关闭并重新打开终端,运行python3 --version和which python3,确认命令可用且路径包含/usr/local/bin/python3。
4、验证venv模块:执行python3 -m venv testenv && source testenv/bin/activate,成功激活后提示符前应显示(testenv)标识。
三、使用pyenv管理多版本Python
pyenv允许在单台Mac上共存多个Python版本,并支持按全局、当前Shell或项目目录粒度灵活切换,适用于需兼容测试、维护多个项目或对Python小版本有严格要求的开发者。
1、确保已安装Homebrew后,执行brew install pyenv。
2、向shell配置文件追加初始化配置:运行echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc(zsh用户)或~/.bash_profile(bash用户)。
3、继续执行echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc与echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc。
4、执行source ~/.zshrc使配置生效,随后运行pyenv install --list | grep "3\.[1-9]"查看可用版本,再用pyenv install 3.12.4安装指定版本。
5、设置版本:执行pyenv global 3.12.4设为全局默认,或pyenv local 3.11.9在当前项目目录下绑定版本。
四、配置虚拟环境并隔离项目依赖
虚拟环境(venv)用于隔离各项目的依赖包,避免不同项目间版本冲突,是Python开发的强制实践规范;macOS自带Python 3已内置venv模块,无需额外安装。
1、创建新项目目录并进入:mkdir myproject && cd myproject。
2、生成虚拟环境:python3 -m venv venv(目录名可自定义)。
3、激活虚拟环境:source venv/bin/activate(激活后命令行前缀将显示(venv))。
4、升级pip并安装基础工具:pip install --upgrade pip setuptools wheel。
5、退出虚拟环境:deactivate;重新进入时仍需执行source venv/bin/activate。
五、在终端中运行Python脚本
终端是最常用、最可控的脚本执行方式,依赖正确的Python路径与脚本权限设置;适用于调试、自动化及CI/CD场景。
1、使用cd命令进入脚本所在目录,例如:cd ~/Documents/my_script.py。
2、确认Python解释器可用:python3 --version;若提示command not found,需检查PATH配置或重装Python。
3、直接运行脚本:python3 your_script_name.py(将your_script_name.py替换为实际文件名)。
4、若需赋予脚本可执行权限并添加Shebang行:在脚本首行插入#!/usr/bin/env python3,保存后执行chmod +x your_script_name.py,再运行./your_script_name.py。
六、使用Python Launcher图形化运行脚本
Python Launcher是官方安装包附带的GUI工具,支持从Finder双击运行脚本、按Option键临时调用首选项、选择Python版本及启用调试,适合不熟悉终端的新手。
1、安装官方.pkg后,在Applications文件夹中找到并打开Python Launcher。
2、在Finder中定位Python脚本,右键单击,选择打开方式 → Python Launcher。
3、或直接将脚本拖拽至Dock中的Python Launcher图标上运行。
4、按住Option键拖拽脚本到Launcher图标,可在运行前弹出临时首选项窗口,为本次执行单独指定Python版本或启用日志输出。
七、通过Automator创建可双击运行的应用程序
Automator可将Python脚本封装为.app应用程序,实现零终端交互的图形化启动,适合交付给非技术用户或部署轻量级工具。
1、启动Automator应用,新建文档并选择应用程序模板。
2、在左侧操作库中搜索运行Shell脚本,将其拖入右侧工作流区域。
3、在脚本框中输入:python3 /path/to/your_script_name.py(将路径替换为脚本绝对路径)。
4、点击菜单栏文件 → 另存为,命名为有意义的名称(如“MyScriptApp”),格式选应用程序,保存至桌面或Applications文件夹。
5、双击生成的.app图标即可运行脚本,输出默认显示在系统控制台(Console.app)中,可通过重定向追加> /tmp/script.log 2>&1记录日志。


















