Windows与Mac下Python安装及环境变量配置新手指南

沈知远
沈知远
发布时间:2026-11-18| 1人浏览过
原创

针对Windows和Mac操作系统新手的Python安装及环境变量PATH配置完整指南,包含安装步骤、底层原理、手动配置与常见错误排查。

要在电脑上正常使用 Python 进行编程与运行脚本,核心目标是完成两项工作:第一是在系统中安装官方提供的解释器程序,第二是让操作系统的命令行终端能够在任何工作目录下通过输入 python 或 python3 直接定位并调用该程序。很多初学者在安装完成后遇到“命令无法识别”或“无法找到对应程序”的提示,根源都在于系统的环境变量 PATH 未能正确建立映射。本文将具体讲解 Windows 与 macOS 平台上的标准安装路径、环境变量配置原理以及手动修正方法,帮助读者建立稳定、清晰的 Python 运行环境。

一、环境变量 PATH 的工作机制

当我们在 Windows 的命令提示符(CMD)或 macOS 的终端(Terminal)中输入一条命令(例如 python script.py)并按下回车时,操作系统本身并不知道 python 这个程序具体保存在哪个磁盘文件夹中。此时,操作系统的寻址逻辑是依据环境变量中的 PATH 列表逐级检索。

PATH 变量本质上是一串以分隔符(Windows 为分号 ;,macOS 为冒号 :)拼接的绝对路径列表。系统会按照声明的前后顺序,依次检查列表中的每一个文件夹。一旦在某个目录中匹配到对应的可执行文件(例如 Windows 下的 python.exe 或 macOS 下的 python3),系统便立即启动该程序并终止后续检索;若遍历完 PATH 中所有的路径仍然没有找到,终端便会输出类似“不是内部或外部命令”或“command not found”的错误提示。

此外,安装 Python 往往伴随着两个核心目录:一是 Python 主程序所在目录(包含 python.exe 或 python3),二是工具脚本目录(名为 Scripts 或 bin,包含包管理工具 pip 及第三方命令行工具)。两个目录均需被包含在 PATH 中,才能确保解释器与扩展库安装工具同时正常运行。

Windows与Mac下Python安装及环境变量配置新手指南
图 1:操作系统通过 PATH 环境变量检索并调用可执行文件的运行过程

二、Windows 下的安装与环境变量配置

Windows 平台推荐使用 Python 官方网站(python.org)提供的可执行安装包(Windows installer 64-bit)。安装过程分为向导自动注入与手动补充配置两种情况。

1. 官方安装向导的关键选项

双击下载好的安装包(例如 python-3.12.x-amd64.exe)后,安装向导首页的底部有一个至关重要的复选框:Add python.exe to PATH。默认情况下该选项处于未勾选状态,这是初学者最容易遗漏的细节。

  • 勾选 Add python.exe to PATH:安装程序会在写入文件后,自动将主程序目录及 Scripts 目录追加到当前用户的 Path 环境变量中,免去后续手动配置步骤。
  • 建议选择 Customize installation:点击该项可检查组件列表(确保勾选 pip、tcl/tk 和 documentation),并在下一步的“Advanced Options”中自定义安装路径。默认安装路径位于深度较深的 AppData 文件夹内,为了便于日常维护与路径记忆,建议将其自定义为根目录下的简短路径,如 C:\Python312。

2. 忘记勾选时的手动配置步骤

若在安装时使用了默认设置且未勾选添加到 PATH,则需要手动将 Python 路径写入系统环境变量。操作步骤如下:

  1. 打开系统属性:按下快捷键 Win + R 呼出“运行”对话框,输入 sysdm.cpl 并回车,直接打开“系统属性”窗口。
  2. 进入环境变量面板:切换到“高级”标签页,点击右下角的“环境变量”按钮。
  3. 编辑 Path 变量:在“用户变量”或“系统变量”区域中找到名为 Path(或 PATH)的条目,选中后点击“编辑”。
  4. 新建路径条目:在弹出的编辑列表中点击“新建”,分别添加两条绝对路径:
    • Python 主程序根目录:例如 C:\Python312\(若使用默认路径,通常位于 C:\Users\用户名\AppData\Local\Programs\Python\Python312\)
    • 工具脚本目录:例如 C:\Python312\Scripts\
  5. 保存并确认生效:依次点击各个对话框的“确定”按钮保存设置。注意:已打开的命令提示符窗口不会自动刷新环境变量,必须彻底关闭并重新打开 CMD 或 PowerShell 窗口。
Windows与Mac下Python安装及环境变量配置新手指南
图 2:Windows 环境下两种配置路径与操作要点

三、macOS 下的安装与环境变量配置

macOS 系统在环境配置上有其特殊性。早期版本的 macOS 曾自带已废弃的 Python 2.7,而现代 macOS 系统自带的通常是随 Xcode Command Line Tools 提供的基础工具链,不建议直接用于日常开发。用户应当自行安装独立的 Python 3 版本。

1. 官方 PKG 安装包方式

访问 Python 官网下载 macOS 64-bit universal2 installer(.pkg 文件)。按照向导完成安装后,官方安装包会将主程序放置在系统框架目录中:

官方框架安装路径
/Library/Frameworks/Python.framework/Versions/3.12/

同时,安装包会自动在 /usr/local/bin 目录下创建指向该框架的软链接(如 python3、pip3)。如果 macOS 的默认 PATH 中已包含 /usr/local/bin,安装完成后即可直接在终端中使用 python3。

2. Homebrew 包管理器安装方式

对于经常使用终端的开发者,通过 Homebrew 进行包管理是更便捷的选择。在终端中执行:

终端命令
brew install python

Homebrew 会自动处理依赖并建立链接。在搭载 Apple Silicon 芯片(M1/M2/M3/M4)的 Mac 上,Homebrew 的可执行文件默认放置在 /opt/homebrew/bin;在搭载 Intel 芯片的 Mac 上,则放置在 /usr/local/bin。

3. 配置 zsh 环境变量与别名

现代 macOS 默认使用的 Shell 是 zsh。zsh 在每次启动新终端会话时,会自动读取用户主目录下的 ~/.zshrc 配置文件。如果终端无法识别 python3 命令,需要将路径写入该文件:

  1. 打开终端,查看当前系统的 PATH 配置:
    查看当前 PATH
    echo $PATH
  2. 使用文本编辑器打开配置文件(如使用系统自带的 nano 或直接通过 echo 追加):
    编辑配置文件
    nano ~/.zshrc
  3. 在文件末尾添加以下内容(根据实际安装方式选择对应路径):
    zsh 环境变量配置示例
    # 若为官方 PKG 安装方式
    export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"
    
    # 若为 Apple Silicon 下的 Homebrew 安装方式
    export PATH="/opt/homebrew/bin:$PATH"
    
    # 设定别名:让输入 python 时直接调用 python3
    alias python="python3"
    alias pip="pip3"
  4. 保存退出后,执行以下命令使配置立即在当前终端生效,无需重启电脑:
    重载配置
    source ~/.zshrc
Windows与Mac下Python安装及环境变量配置新手指南
图 3:Windows 与 macOS 在命令调用、配置文件及生效机制上的核心差异

四、环境验证与常见故障排查

完成安装与环境变量配置后,必须在终端中进行实质性验证。请按照以下步骤检查环境可用性,并针对可能遇到的报错进行定位。

1. 完整性验证命令

新建一个终端窗口,分别执行以下指令:

检查 Python 解释器版本
# Windows 下
python --version

# macOS 下
python3 --version

终端应返回类似 Python 3.12.3 的具体版本信息。随后检查包管理器 pip 是否可用:

检查 Pip 版本及对应路径
# Windows 下
pip --version

# macOS 下
pip3 --version

正常的输出结果不仅包含 pip 的版本号,还会明确显示其绑定的 Python 物理目录(例如 from C:\Python312\Lib\site-packages\pip (python 3.12))。最后执行单行代码测试运行能力:

执行测试代码
python -c "import sys; print('环境正常,当前解释器路径为:', sys.executable)"

2. 新手高频问题与排查清单

  • 问题一:Windows 下在终端输入 python,自动弹出了 Windows 应用商店(Microsoft Store)
    原因:Windows 10/11 系统在默认的 PATH 路径(%USERPROFILE%\AppData\Local\Microsoft\WindowsApps)中内置了空壳的 python.exe 别名。当用户自己的 Python 安装路径排在其后或未正确添加时,系统就会优先触发该别名并跳转应用商店。
    解决办法:打开 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”(App execution aliases),在列表中找到“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”,将其开关彻底关闭;同时确保自定义的 Python 路径在 PATH 列表中处于靠前位置。
  • 问题二:输入 python 提示“不是内部或外部命令”或“command not found”
    原因:环境变量配置未完成、路径拼写存在错误,或者终端未重启。
    解决办法:在 Windows 运行 where python,在 Mac 运行 which python3。若无任何输出,说明 PATH 中确实没有该程序;请仔细核对安装路径中是否多出空格或少写了层级目录,并确认关闭所有旧终端窗口后重新启动。
  • 问题三:可以使用 python,但输入 pip 提示命令不存在
    原因:仅将 Python 根目录加入了 PATH,而漏掉了工具集 Scripts(Windows)或 bin(macOS)目录。
    解决办法:将 C:\Python312\Scripts 加入 Windows PATH,或在终端临时使用模块调用模式代替独立命令:python -m pip install 库名。
Windows与Mac下Python安装及环境变量配置新手指南
图 4:跨平台 Python 环境验证步骤与典型故障排障清单

五、全流程核心操作对照总结

为了便于查阅与对照,以下表格对 Windows 与 macOS 两套环境在安装与配置过程中的核心要素进行了汇总:

对比维度 Windows 平台 macOS 平台
推荐安装渠道 Python 官网 64-bit 独立安装程序 Python 官网 pkg 安装包 或 Homebrew
默认终端程序 命令提示符(CMD)或 PowerShell 终端(Terminal,默认 Shell 为 zsh)
必备 PATH 条目 主安装目录与 Scripts 子目录(共 2 项) Frameworks 对应 bin 目录 或 /opt/homebrew/bin
配置修改方式 系统属性 -> 环境变量 GUI 界面 编辑 ~/.zshrc 脚本文件
测试与验证指令 python --version 与 where python python3 --version 与 which python3
配置生效操作 关闭并重新打开 CMD / PowerShell 执行 source ~/.zshrc 或重启终端

完成上述配置后,Python 解释器已具备全局调用能力。初学者在此基础上开展日常学习时,可结合具体的项目需要建立虚拟环境(使用 python -m venv myenv),以隔离不同工程之间的第三方依赖包,从而维持全局 Python 环境的整洁与稳定。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。