Python怎么安装及配置环境变量

一颗松果

发布时间：2026-11-09 | 7人浏览过

原创

针对Python初学者的完整安装与环境变量配置实用指南。详细讲解从官方下载、安装向导核心选项设置，到系统PATH环境变量的手动配置、多版本优先级调整与终端验证排错全流程。

在计算机上安装 Python 并完成环境配置，核心目标是达成两个关键环节：一是完整获取并安装 Python 解释器主体及其官方附带的脚本工具集；二是把 Python 主程序目录及 Scripts 目录准确注册至操作系统的 PATH 环境变量中。配置完成后，无论当前命令行窗口停留在哪个磁盘分区或文件夹，均可直接识别并调用 python 与 pip 指令，使后续的代码编写、库依赖管理及自动化运行顺畅展开。

Python怎么安装及配置环境变量 — 图 0：Python 安装与系统 PATH 环境变量调用链路全景图

一、为什么必须配置 PATH 环境变量

很多初学者在刚开始接触编程时，往往会产生一个疑问：软件安装包已经顺利运行完毕，为什么在命令行终端输入 python 时，系统依然会弹出“'python' 不是内部或外部命令”的提示？

这个现象与操作系统的可执行程序检索机制直接相关。当你在终端（如 Windows 的命令提示符、PowerShell 或 macOS 的 Terminal）中输入一个命令并回车时，操作系统会遵循固定的查找逻辑：首先在“当前工作目录”中查找是否存在与该命令同名的可执行文件；如果当前目录下没有找到，系统就会遍历环境变量 PATH 中所登记的一连串文件夹路径。一旦在某一个登记路径下找到了对应的程序文件（如 python.exe），系统就会立即启动它；如果搜遍了 PATH 列表中的所有路径依然一无所获，系统便会终止检索并抛出命令无法识别的报错。

因此，配置环境变量的实质，就是向操作系统的全局检索名单中“登记”Python 安装目录的过程。只要完成登记，操作系统就能随时随地根据名字找到 Python 解释器及其包管理器 pip，不必再要求使用者每次都手动输入冗长的绝对物理路径。

二、Python 官方安装程序的下载与安装步骤

获取 Python 最稳妥、最干净的方式始终是访问其官方网站。避免通过各类第三方软件下载站或所谓的一键捆绑工具获取安装包，以防系统被植入流氓广告插件或遇到被篡改的依赖库。

1. 获取适合本机的安装包

在浏览器中输入官方主页 https://www.python.org/downloads/。网站通常会根据读者的操作系统自动推荐合适的下载按钮。在绝大多数现代个人计算机上，请务必核对以下两项属性：

版本类型：选择处于长期支持维护期内的稳定版本（Stable Releases），日常学习与通用项目开发建议采用成熟版本（如 Python 3.12 或 3.11），以保证大部分科学计算库与 Web 框架均具备编译就绪的二进制 wheel 包。
系统架构：选择 64-bit 架构的安装程序（文件名称通常带有 amd64 或 x86-64 字样），除非计算机硬件属于极早期的 32 位架构。

2. 运行安装向导的核心关键点

双击打开下载好的 .exe 安装程序文件。在启动的安装首屏界面中，有两个决定后续使用体验的至关重要选项：

必须勾选底部复选框：界面最下方有一行醒目的选项 Add python.exe to PATH（在某些旧版本中为 Add Python 3.x to PATH）。务必首先勾选此复选框！勾选后，官方安装器会在释放文件的同时自动将安装目录写入系统 PATH，省去后续手动修改环境变量的绝大部分繁琐工作。
推荐选择“Customize installation”（自定义安装）：点击进入自定义选项界面。

3. 自定义安装选项与规范路径设定

进入“Optional Features”（可选功能）界面，默认情况下包括 Documentation（文档）、pip（核心包管理工具）、tcl/tk and IDLE（内置轻量编辑器）以及 Python test suite。建议保留默认的全选状态，直接点击“Next”。

随后进入“Advanced Options”（高级选项）界面，此处涉及文件存放目录与全局权限：

建议勾选 Install Python for all users（为所有用户安装），勾选后系统会将安装路径切换至更加规范的顶层目录。
重置安装路径（Customize install location）：默认路径往往位于深度极深、隐藏且包含特殊字符的 C:\Users\用户名\AppData\Local\Programs\Python\... 中。如果读者的 Windows 用户名包含中文汉字或空格，后续安装部分需要调用底层 C 编译器的 Python 扩展库时容易发生路径编码解析错误。强烈建议将安装路径手动修改为简洁、规范的纯英文路径，例如：
```
C:\Python312
```

确认无误后点击“Install”按钮，等待系统进度条完成安装。

安装结束提示（Disable path length limit）：
安装完成后，界面若出现“Disable path length limit”（禁用系统的 260 字符路径长度限制）按钮，建议主动点击一次。这将允许 Windows 操作系统处理深度嵌套的代码包路径，有效防止以后安装大型复杂项目依赖时发生文件名截断异常。

三、手动配置与核查环境变量（Windows 系统）

如果在安装过程中读者未注意到底部的 Add python.exe to PATH 复选框，或者当前环境属于由他人安装但未配置全局命令的计算机，则需要手动将路径补齐到系统的环境变量中。

1. 打开系统环境变量配置面板

按照以下明确路径调出设置面板：

使用快捷键 Win + R 呼出“运行”对话框，直接输入以下系统命令并按回车：
```
sysdm.cpl
```
（该命令将直接打开经典的“系统属性”窗口，省去在 Windows 10/11 多层现代设置菜单中寻找的时间）。
在弹出的“系统属性”窗口中，切换到顶部的“高级”选项卡。
点击右下角的“环境变量(N)...”按钮，进入环境变量管理界面。

2. 在 Path 变量中添加双路径

在环境变量窗口中，上半部分为“用户变量”，下半部分为“系统变量”。为了保证计算机上所有账户及后台服务均可统一调用，推荐直接在“系统变量”区域中进行配置：

在“系统变量”列表中向下滚动，找到名为 Path（大小写不敏感）的一行，点击选中它，然后点击下方的“编辑(I)...”按钮。
在展开的“编辑环境变量”子窗口中，点击右侧的“新建(N)”按钮，填入 Python 的根安装目录，例如：
```
C:\Python312\
```
再次点击“新建(N)”按钮，填入 Python 目录下的 Scripts 子文件夹路径，例如：
```
C:\Python312\Scripts\
```
连续点击三个窗口的“确定”按钮完成保存并退出。

为什么一定要同时添加两条路径？
根目录 C:\Python312\ 下存放的是核心解释器 python.exe，负责执行 python 基础命令及运行 .py 脚本；而子目录 C:\Python312\Scripts\ 下存放的是 pip.exe 以及后续通过 pip 安装的各种第三方终端工具（如 pytest, black, flake8 等）。如果漏加了 Scripts 目录，虽然能够运行 python，但每次执行 pip install 时依然会报“pip 不是内部或外部命令”。

四、macOS 与 Linux 系统的配置方法

在基于类 Unix 架构的 macOS 或 Linux 发行版中，Python 同样依赖系统的 $PATH 变量。现代 macOS 默认的终端 Shell 为 zsh，而多数 Linux 发行版默认为 bash。

1. 通过官方包或包管理工具安装

macOS：可以直接在官网下载 macOS 64-bit universal2 installer 双击安装，安装包会自动在 /usr/local/bin 目录下建立软链接。或者使用 Homebrew 进行安装：
```
brew install python@3.12
```

Linux (Ubuntu / Debian)：使用官方源直接安装：

sudo apt update
sudo apt install python3 python3-pip python3-venv

2. 配置 Shell 配置文件

如果系统提示找不到新安装的 Python 或 Homebrew 安装路径未被引入，可以通过编辑当前用户的 Shell 配置文件进行显式声明：

# 如果当前使用 zsh（macOS 默认），打开 ~/.zshrc
nano ~/.zshrc

# 在文件最后一行添加 PATH 导出语句（以 Homebrew 或本地安装路径为例）：
export PATH="/usr/local/bin:/usr/local/opt/python/libexec/bin:$PATH"

# 保存退出后，执行以下命令使配置立即生效：
source ~/.zshrc

五、验证安装与环境变量是否生效

配置完成之后，绝不能仅凭感觉认定已经成功，必须通过终端发出命令进行确凿的闭环验证。

特别注意：重新开启命令行窗口
环境变量的修改不会自动刷新已经打开的旧终端窗口。完成上述所有设置后，必须完全关闭所有已打开的 CMD 或 PowerShell 窗口，重新打开一个新的窗口，否则旧终端读取的依然是修改前的旧环境变量副本。

1. 检查 Python 解释器版本

在新开的命令行窗口中输入以下命令：

> python --version

系统应立即返回对应的具体版本号（例如：Python 3.12.3）。如果返回了具体的版本号，说明系统已经成功定位并运行了主解释器。

2. 检查 pip 包管理器版本

继续在终端中输入：

> pip --version

正常情况下，终端会输出 pip 的版本以及它所归属的物理路径，例如：

pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

3. 查询实际执行路径

为防止当前调用的 Python 来自系统其他隐式残留路径，可以使用路径查询命令确认其实际来源：

# 在 Windows CMD 中输入：
> where python

# 在 macOS / Linux 终端中输入：
$ which python3

示例输出中首行展示的绝对路径，应当与读者此前设置的安装目录（如 C:\Python312\python.exe）完全吻合。

4. 交互式环境测试

在终端中直接输入 python 并回车，进入 Python 的交互式解释器（终端前缀会变成 >>>）。输入一段基础输出代码：

>>> print("Environment ready!")
Environment ready!
>>> exit()

看到控制台正确打印文本并通过 exit() 退出，证明整个运行环境已完全就绪。

六、常见问题排查与注意事项

在实际操作过程中，读者可能还会遭遇几种极具代表性的特殊情况，以下提供针对性排查思路：

故障现象	主要原因分析	具体解决方法
输入 python 自动跳转 Windows 应用商店	Windows 10/11 系统内置了名为“应用执行别名”的占位符，默认拦截了未精准命中的 python 命令并引导至商店页面。	进入 Windows“系统设置” → 搜索并打开“管理应用执行别名”，将列表中与 `python.exe` 和 `python3.exe` 相关的开关全部关闭。
显示的版本号与刚安装的版本不一致	系统中同时存在旧版本 Python（或 Anaconda、Git 自带的轻量环境），且旧版本在 PATH 变量中的排位高于新版本。	在环境变量的 Path 编辑窗口中，选中新版 Python 的两条路径，点击右侧的“上移”按钮，将其移动到最顶部，优先被系统命中。
提示“pip 需要升级”的黄色警告	安装包内置的 pip 版本稍早于官方 PyPI 当前最新版本。	在终端中执行官方推荐的自更新命令： `python -m pip install --upgrade pip`。
pip 安装第三方库时提示 Permission Denied	安装路径被设置在受保护的系统目录（如 Program Files），普通用户命令行缺少写权限。	右键点击命令提示符选择“以管理员身份运行”，或在安装命令末尾附加 `--user` 参数安装至当前用户目录。

七、总结

配置 Python 运行环境并不神秘，其技术本质就是“规范安装文件路径”与“建立系统变量索引”。遵循以下清单，即可保障环境长期稳定无虞：

安装阶段：优先通过官方途径获取 64 位稳定版安装程序；养成首屏勾选“Add python.exe to PATH”的习惯；将安装路径规范至无汉字、无空格的英文字符目录（如 C:\Python312）。
配置阶段：确保环境变量中同时包含主程序路径与 Scripts 子目录路径，缺一不可。
验证阶段：变更设置后重启终端窗口，利用 python --version、pip --version 与 where python 形成完整校验闭环。