Python 安装与环境配置：Windows、macOS、Linux 完整指南（第2集）

Python 安装与环境配置：Windows、macOS、Linux 完整指南

Python 100讲 · 第02篇｜零基础入门｜前置知识：无

本篇目标： 正确安装 Python、核对解释器版本、运行第一个 .py 文件，并弄清 PATH、pip 和虚拟环境各有什么用。

适用系统： Windows、macOS、Linux。请只阅读自己所用系统的安装部分。

写在前面：为什么别人敲一下命令就能运行，我却不行？

刚开始学 Python，最常遇到的困难往往不是代码本身，而是电脑里不知道有没有装 Python、命令找不到、装了多个版本，或明明安装了一个库却仍提示找不到。本篇从下载安装到运行程序，分别带你完成 Windows、macOS、Linux 的环境准备。你不需要懂专业术语，按自己的操作系统逐步操作即可。最后我们还会建立一个独立的项目环境，让后面的学习少受版本冲突影响。

一、先看懂三个词：Python、终端和 PATH

在开始安装之前，认识三个词就够了。

Python 解释器 ：真正执行 .py 程序的软件。它不是某个代码文件，也不等于你写代码用的编辑器。
终端（命令行）：你输入命令、查看结果的窗口。Windows 常用 PowerShell 或命令提示符；macOS 和 Linux 常用"终端"。
PATH 环境变量 ：操作系统寻找命令的"目录清单"。输入 python 时，系统会按照约定的位置或路径设置寻找可以执行的程序。如果找不到，可能不是 Python 坏了，而是命令所在位置没有正确配置。

可以把三者理解为：解释器是厨师，代码是菜谱，终端是点菜窗口；PATH 帮助系统找到厨师在哪儿。

另外，还会见到 pip：它是 Python 的包安装工具。一个"包"可以理解成别人已经写好的、可以供我们使用的功能集合。本篇先学会检查 pip，不必安装任何额外第三方包。

为什么本系列选择 Python 3.14？

截至 2026 年 10 月 28 日 ，Python 官方已发布 3.15 系列，而 3.14.10 是 3.14 系列的维护版本之一（于 2026 年 10 月 25 日发布）。

为让整套课程尽量保持统一，我们选择 Python 3.14 作为主要教学验证基线，推荐安装其当前受支持的维护版本，而不是安装已经过时的 3.14.0 首发版。

注意： 下面的操作不会保证所有 Linux 发行版都能从自己的软件仓库安装到 3.14；安装完成后请以电脑实际显示的版本为准。版本更新较快，阅读本文时可再次查看 Python 官方发布页。

二、Windows 安装：先安装管理器，再装 Python 3.14

如果你用的是 Windows，请跟着本节操作；macOS 用户可直接看第三节，Linux 用户看第四节。

第 1 步：从官网下载

打开 Python 官方网站：

https://www.python.org/downloads/

Windows 当前的官方推荐方式之一是 Python install manager（Python 安装管理器） ，它与旧教程中常见的经典 Add Python to PATH 安装向导不是同一套界面。

进入官网后，下载面向 Windows 的 Python install manager。下载完成后双击安装文件，按屏幕提示完成安装。也可以使用官方提供的 Microsoft Store 安装方式。

安全提醒： 不要从不明网盘或所谓"一键绿色版"下载解释器；遇到安装失败，也不要随便关闭杀毒软件。

第 2 步：打开 PowerShell

按键盘 Win + S ，搜索 PowerShell，点击打开。

你会看到一个可以输入文字的窗口。下面每条命令，输入后都要按 Enter（回车） 执行。代码块中不需要输入说明文字。

先检查安装管理器是否可用：

powershell 复制代码

py list

如果正常，会看到已安装的 Python 运行时列表。具体格式由安装管理器版本决定；刚安装管理器、还没有安装 Python 运行时时，也可能提示没有已安装版本。

如果 py list 提示命令找不到，暂时不要修改系统环境变量：先关闭再重新打开 PowerShell，再确认 Python install manager 是否成功安装，后文还有排错方法。

第 3 步：安装 3.14

在 PowerShell 中执行：

powershell 复制代码

py install 3.14

这是通过新版 Python 安装管理器安装 Python 3.14 系列运行时的命令。它需要联网；根据网络情况可能需要一些时间。

完成后执行：

powershell 复制代码

py -V:3.14 --version

预期： 显示 Python 3.14.x，例如截至本文核验日期的维护版可能是 Python 3.14.10。以你实际安装的修订版本为准。

再查看当前电脑有哪些 Python 版本：

powershell 复制代码

py list

如果你以前装过 Python，命令 python --version 显示 3.15 或别的版本，不等于 3.14 安装失败；我们可以通过 py -V:3.14 明确指定使用哪个版本。

如果旧电脑的 py 仍是传统启动器，而不支持 py install，请先使用新版官方安装管理器。安装管理器还提供 pymanager 命令，可用于区分新旧命令冲突；不要直接在系统目录里删除旧 Python 文件。

第 4 步：验证 Python 和 pip

继续输入：

powershell 复制代码

py -V:3.14 -c "print('环境检查成功')"

正常应显示：

text 复制代码

环境检查成功

再检查与 Python 3.14 关联的 pip：

powershell 复制代码

py -V:3.14 -m pip --version

如果成功，输出里会包含 pip 版本及它所关联的 Python 版本信息。pip 的具体版本号可能变化，不需要和别人的截图完全相同。

到这里，Windows 上的 Python 3.14 已经具备运行基础示例的条件。

三、macOS 安装：用官方 `.pkg` 安装包

第 1 步：从官方页面选择 3.14

打开：

https://www.python.org/downloads/macos/

找到 Python 3.14 系列的当前维护版本 ，点击 Download macOS installer。

下载的是 macOS 常见的 .pkg 安装文件。Python 官方安装器会在支持的 Mac 系统上提供适当的安装内容，具体系统最低要求以所选版本下载页和安装包说明为准。

第 2 步：双击安装包

双击下载的 .pkg 文件，依次阅读提示，点击"继续"，确认许可协议，按默认方式安装。

如果 macOS 请求管理员密码，应先确认正在安装的是从 python.org 下载的正式安装器。

安装成功后还要做一个容易遗漏的步骤：

在"应用程序"中打开 Python 3.14 文件夹，双击其中的：

text 复制代码

Install Certificates.command

按照官方安装说明完成证书安装步骤。这一步关系到部分 HTTPS 连接能否正确验证证书。

第 3 步：查看 Python 版本

打开 Mac 的 终端（Terminal），输入：

bash 复制代码

python3.14 --version

如果安装成功，应该显示 Python 3.14.x。

再运行：

bash 复制代码

python3.14 -c "print('环境检查成功')"

预期输出：

text 复制代码

环境检查成功

再检查 pip：

bash 复制代码

python3.14 -m pip --version

第 4 步：如果输入 `python3`，却显示旧版本怎么办？

macOS 有时还包含供系统或开发工具使用的 Python。你可能看到 python3 --version 与 python3.14 --version 不一样。

这是可能出现的正常情况。不要删除或覆盖 Apple 管理的 /usr/bin/python3。

本系列在 macOS 上需要指定 3.14 时，使用：

bash 复制代码

python3.14

如果它提示找不到命令，可以先用官方安装的常见路径检查：

bash 复制代码

/Library/Frameworks/Python.framework/Versions/3.14/bin/python3.14 --version

这个路径适用于 python.org 默认框架安装方式；若你选择了其他安装方式，路径可能不同。

四、Linux 安装：优先使用发行版自己的软件源

Linux 与 Windows、macOS 有一个明显区别：许多 Linux 系统原本就安装了 Python，它可能用于系统软件的正常运行。

因此，Linux 新手不要随意删除系统 Python，也不要直接把 /usr/bin/python3 改成自己下载的版本。

先打开终端，输入：

bash 复制代码

python3 --version

如果已经能显示 Python 3.x.x，说明系统里至少存在一个可用的 Python 3 解释器。

情况 A：Ubuntu

Ubuntu 官方开发指南推荐使用发行版管理的软件包安装完整 Python 环境。例如：

bash 复制代码

sudo apt update
sudo apt install python3-full python3-pip

如果提示输入密码，按系统提示操作。输入 Linux 终端密码时通常不会显示星号，这是正常现象。

安装后检查：

bash 复制代码

python3 --version
python3 -m pip --version

注意：这里安装的是你当前 Ubuntu 版本的软件仓库提供的 Python，并不保证一定是 3.14。

情况 B：Debian

在 Debian 上，可以使用软件包管理器安装 Python 和虚拟环境、pip 的相关组件：

bash 复制代码

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

安装后检查：

bash 复制代码

python3 --version

情况 C：Fedora

Fedora 通常已经预装 Python 3。先检查：

bash 复制代码

python3 --version

若缺少 pip，可依照 Fedora 官方开发者文档安装：

bash 复制代码

sudo dnf install python3-pip

随后使用 python3 -m pip --version 检查。

Linux 版本不是 3.14，怎么办？

例如 python3 --version 显示 3.12 或 3.13：先不要修改系统默认 Python。

如果只是做本篇 print() 示例，现有受支持的 Python 3 版本通常就能练习；但它不能算作在 3.14 基线上完成了验证。

后续若需要严格使用 3.14，应查阅自己 Linux 发行版的官方软件仓库和版本安装说明，在它支持时单独安装对应版本，或由有经验的人按 Python 官方源码构建文档搭建独立环境。不要为追求版本一致随意替换系统解释器。

五、PATH 究竟是什么？为什么会"找不到 Python"？

想象电脑里有很多抽屉，每个抽屉放着不同的工具。当你在终端里输入 python，系统需要知道该去哪一个抽屉找它。

PATH 可以理解为系统搜索这些抽屉的顺序。

不同系统有不同的检查方式：

操作系统 / 终端	查看命令定位
Windows PowerShell	`Get-Command python`
Windows 命令提示符	`where python`
macOS / Linux	`command -v python3`

Windows 上，如果你主要使用新版安装管理器，也可以先用 py list 确认已安装的运行时，再用 py -V:3.14 --version 测试。

macOS 上可以用 command -v python3.14 检查指定版本的可执行文件是否可找到。

新手排查顺序：

确认真的安装了 Python，而不只是下载了安装器；
关闭并重新打开终端，让新的 PATH 设置生效；
尝试官方推荐的带版本命令；
再依据对应系统的官方说明检查 PATH 或应用执行别名。

不要直接复制网上陌生人的整个 PATH 内容覆盖自己的设置，也不要把系统里原有路径全部删除。

六、为什么不能把所有库都装到系统 Python？认识虚拟环境

到这里，解释器已经能运行，为什么还要创建虚拟环境？

假设你有两个 Python 项目：一个需要某个库的新版本，另一个只能使用旧版本。如果全部装在同一个地方，就可能产生冲突。

虚拟环境就是给一个项目建立相对独立的软件包空间。它使用已经安装的 Python 作为基础，默认把这个项目安装的包与其他项目区分开。

它不会凭空安装一个新版本的基础 Python：用 3.14 创建的虚拟环境基于 3.14，用 3.13 创建的虚拟环境基于 3.13。

虚拟环境常用名字是 .venv。

第 1 步：进入你的练习文件夹

先在电脑上建立一个名为 Python100 的文件夹，然后打开位于这个文件夹内的终端。

如果不知道怎么打开，可以参考：

Windows：在文件资源管理器中进入 Python100 文件夹，在地址栏输入 powershell 后回车；
macOS / Linux：在终端使用 cd 切换到你创建的 Python100 文件夹。

下面命令都假设你已经位于这个文件夹里。

第 2 步：创建 `.venv`

Windows（PowerShell）：

powershell 复制代码

py -V:3.14 -m venv .venv

macOS：

bash 复制代码

python3.14 -m venv .venv

Linux：

bash 复制代码

python3 -m venv .venv

Linux 的这条命令会使用当前 python3 对应的版本，可能不是 3.14。创建前请先用 python3 --version 核对。

创建成功后，当前文件夹里会出现 .venv 子文件夹。这个目录是环境文件，不要把自己的学习代码写进 .venv 里面。

第 3 步：启用环境（推荐方式）

Windows PowerShell：

powershell 复制代码

.\.venv\Scripts\Activate.ps1

Windows 命令提示符（cmd）：

bat 复制代码

.venv\Scripts\activate.bat

macOS / Linux（bash 或 zsh）：

bash 复制代码

source .venv/bin/activate

成功后，你可能会在终端提示符前看到 (.venv)。这代表当前终端正在使用这个项目的虚拟环境。

现在输入：

bash 复制代码

python --version

它应当显示创建该虚拟环境所用的 Python 版本。

Windows PowerShell 若提示脚本因执行策略被阻止，不必为本教程关闭安全限制 。可以使用下面的"无需激活"方法，或在 cmd 中运行 activate.bat。

第 4 步：不激活，也能直接使用虚拟环境

这一点非常实用：激活只是方便使用，并不是必需的。

Windows：

powershell 复制代码

.\.venv\Scripts\python.exe --version

macOS / Linux：

bash 复制代码

.venv/bin/python --version

如果想确认这个虚拟环境的 pip，可用：

Windows：

powershell 复制代码

.\.venv\Scripts\python.exe -m pip --version

macOS / Linux：

bash 复制代码

.venv/bin/python -m pip --version

第 5 步：离开虚拟环境

如果已激活虚拟环境，在终端输入：

text 复制代码

deactivate

回车后，终端通常会恢复到原先环境。

七、pip 的正确用法：保证包装进想要的 Python

pip 是 Python 常用的包安装工具。

你可能见过下面的命令：

bash 复制代码

pip install 某个包

但电脑有多个 Python 版本时，直接执行 pip 不一定能让你直观看出包被装到了哪里。

因此，本专栏推荐：

bash 复制代码

python -m pip --version

这里的 python 如果来自已经激活的 .venv，那么 -m pip 就会使用这个环境中的 pip。

你也可以在虚拟环境中检查已安装的软件包：

bash 复制代码

python -m pip list

如果将来确实要安装一个第三方包，基本形式是：

bash 复制代码

python -m pip install 包名

包名 是占位文字，不要照抄执行。实际安装时要换成包的真实名称，并确认来源可信。本篇不要求安装第三方包。

特别提醒：

避免在 Linux 系统 Python 上直接运行 sudo pip install ...；
遇到 externally-managed-environment，应优先创建并使用虚拟环境；
不要为了绕过系统限制随便加入 --break-system-packages；
提示权限不足时，先核对当前解释器和环境，而不是直接以管理员身份安装所有包。

八、真正运行一个 `.py` 文件

到这里，我们终于让 Python 为我们做一件事。

第 1 步：创建 `lesson02.py`

在 Python100 文件夹中新建文本文件，保存为 lesson02.py ，编码选 UTF-8。Windows 用户要注意文件不要意外命名为 lesson02.py.txt。

把下面代码完整复制进去：

python 复制代码

print("================================")
print("  Python 100讲｜环境检查成功")
print("================================")
print("你好，Python！")
print("这是我运行的第二个 Python 程序。")

这里只有 print()，不需要变量、循环、函数定义，也不需要输入个人信息。

第 2 步：运行程序

确保终端当前位于保存 lesson02.py 的文件夹中。

如果已经激活虚拟环境，三个系统都可以运行：

bash 复制代码

python lesson02.py

如果没有激活虚拟环境，也可以明确指定解释器。

Windows：

powershell 复制代码

.\.venv\Scripts\python.exe lesson02.py

macOS / Linux：

bash 复制代码

.venv/bin/python lesson02.py

第 3 步：查看预期输出

text 复制代码

================================
  Python 100讲｜环境检查成功
================================
你好，Python！
这是我运行的第二个 Python 程序。

如果这几行文字按预期出现，就说明你已经学会了最基本的 Python 运行过程：编辑文件 → 保存 → 终端执行 → 检查输出。

九、常见错误排查：看到报错先别慌

现象或报错	常见原因	建议处理
`python` 找不到	PATH 或命令别名没有配置，或未安装	按系统章节用带版本的命令检查，重新打开终端
Windows 的 `py install` 不支持	使用的是旧启动器，非新版安装管理器	安装或更新官方 Python install manager
`No such file` 或 `can't open file`	当前目录不对，或文件名有误	核对 `lesson02.py` 所在文件夹和扩展名
`No module named pip`	当前解释器未安装 pip，或使用了错误环境	先检查解释器版本；优先在可用的虚拟环境中处理
`No module named venv` / `ensurepip` 失败	Linux 环境可能缺少 venv 组件	根据发行版官方文档安装 `python3-venv` 或完整 Python 组件
`externally-managed-environment`	正试图修改受系统管理的 Python 包	使用 `.venv`，不要强行覆盖系统限制
PowerShell 不允许执行 `Activate.ps1`	脚本执行策略限制	改用环境内的 `python.exe` 直接运行
安装库后 `ModuleNotFoundError`	pip 与运行程序的解释器不一致	检查 `python -m pip --version` 与所用解释器
macOS 的 `python3` 不是 3.14	系统或开发工具 Python 与官网安装版共存	使用 `python3.14`，不要删除系统解释器
`Permission denied`	权限不足或安装位置不适合	优先使用当前用户可写目录和项目虚拟环境

还有两种非常常见的代码错误。

错误示例 A：漏写结束引号（故意错误，不要写进正式代码）：

python 复制代码

print("你好，Python！)

运行时会出现包含 SyntaxError 的错误信息。正确写法：

python 复制代码

print("你好，Python！")

错误示例 B：文字忘记加引号（故意错误）：

python 复制代码

print(欢迎学习)

如果没有定义叫"欢迎学习"的名称，就会出现 NameError。正确写法：

python 复制代码

print("欢迎学习")

本篇小工具不接收用户输入，所以不存在"输入负数、空字符串"的业务校验问题。测试重点是：解释器是否正确、文件是否存在、代码是否完整，以及错误信息能否帮助我们定位问题。

十、安装成功检查清单

完成后，请按顺序核对：

Python 是从官方或操作系统发行版认可的软件源安装的；
能用适合自己系统的命令看到 Python 版本；
知道如何辨认是否使用了 Python 3.14；
能检查 pip 所关联的 Python；
能在 Python100 文件夹中创建 .venv；
能用虚拟环境的解释器运行 lesson02.py；
输出和上面的五行内容一致；
没有删除、覆盖系统自带的 Python；
知道虚拟环境无法自动把旧版 Python 变成 3.14。

最重要的验收标准不是"屏幕截图和教程一样"，而是"你能解释自己使用了哪个 Python，并成功运行程序"。

十一、课后练习：从会照做到会检查

练习 1：记录你的 Python 版本（入门）

使用本文对应系统的版本检查命令，记录运行结果。思考：这是默认版本，还是你明确指定的 3.14？

练习 2：检查 pip 与虚拟环境（基础）

创建 .venv，在激活前和激活后分别检查 Python 路径或版本，以及 pip 的位置。观察是否出现 .venv 字样。

练习 3：制作自己的欢迎页（挑战）

修改 lesson02.py，将第三行标题改成"我的 Python 学习环境"，再新增一句 print()，输出"我已经成功运行 Python 程序"。

要求：只用 print()，不需要学习新语法。最后对照实际输出确认修改生效。

十二、总结：配置正确的环境，比急着安装一堆库重要

今天，我们完成了学习 Python 的关键准备：

认识解释器、终端、PATH 和 pip；
学会按 Windows、macOS、Linux 的官方推荐方式安装或检查 Python；
理解系统 Python、项目虚拟环境和软件包管理的区别；
知道如何避免多版本冲突与系统包被覆盖；
真正运行了 lesson02.py。

下一篇预告：《VS Code 与 Python 调试：从运行程序到定位错误》。我们会学习更方便的代码编辑器，并借助断点、变量视图等工具逐步发现程序的问题。

官方资料与验证说明

本文主要根据以下官方资料编写，核对日期：2026 年 10 月 28 日。

真实验证范围： 文中的 lesson02.py 已在 Linux / Python 3.13.5 环境实际运行，输出与预期一致；虚拟环境创建、pip 检查、激活与退出也已测试。Windows、macOS 的安装步骤以及 Python 3.14 环境目前仅按官方资料核对，未在相应实际系统上执行安装测试。在正式发布前，建议再按目标操作系统和实际 Python 3.14 维护版本进行复核。

Python 安装与环境配置：Windows、macOS、Linux 完整指南（第2集）