macOS需手动安装Python 3并配置开发环境,因系统默认仅含Python 2.7或不预装;推荐用Homebrew安装、官方包安装、创建venv虚拟环境、配置VS Code扩展。

如果您在 macOS 系统上尚未安装 Python 或需要配置标准的 Python 开发环境,则可能是由于系统默认仅预装 Python 2.7(macOS 10.15 及更早版本)或完全不预装 Python(macOS 12.3+),且缺少 pip、venv 等关键组件。以下是完成 MAC 上 Python 安装与开发环境配置的具体步骤:
一、使用 Homebrew 安装 Python 3
Homebrew 是 macOS 上最主流的包管理器,通过它可一键安装最新稳定版 Python 3,并自动配置 pip、setuptools 和 venv 模块。该方式安装的 Python 独立于系统 Python,避免权限与路径冲突。
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 命令)。
4、验证安装:输入 python3 --version 和 pip3 --version,确认输出类似 “Python 3.12.4” 和 “pip 24.1.2”。
二、通过官方安装包直接安装
此方法不依赖第三方工具,适用于无法联网使用 Homebrew 或需指定版本(如 Python 3.11)的场景。安装包自带图形化向导,并自动将 Python 添加至 PATH(需勾选对应选项)。
1、访问 https://www.python.org/downloads/mac/,下载适用于 Intel 或 Apple Silicon 的最新 macOS 64-bit ARM64 installer。
2、双击下载的 .pkg 文件,按提示进行安装;在“安装类型”页中,务必勾选 “Add Python to PATH”。
3、安装完成后,重启终端,运行 which python3,确认返回路径包含 /usr/local/bin/python3 或 /opt/homebrew/bin/python3。
三、配置虚拟环境并启用开发支持
Python 虚拟环境(venv)用于隔离项目依赖,避免全局包污染。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
四、配置 VS Code 作为 Python 编辑器
VS Code 是 macOS 上轻量且功能完备的 Python 开发工具,需配合官方 Python 扩展实现语法高亮、调试、智能补全等功能。
1、从 https://code.visualstudio.com/ 下载并安装 VS Code。
2、启动 VS Code,点击左侧扩展图标,搜索并安装 “Python” by Microsoft(ID: ms-python.python)。
3、打开任意 .py 文件,在右下角状态栏点击 Python 解释器选择按钮,从列表中选择已安装的 python3.x 路径(如 /usr/local/bin/python3)。
4、新建终端(Ctrl+`),确认其继承当前工作区 Python 环境:执行 which python 应返回虚拟环境内路径。










