Python 安装与环境配置教程

安装前先明确两件事

为什么推荐直接安装 Python 3

现在学习和开发 Python，默认选择 Python 3 即可。大多数教程、第三方库和 IDE 都围绕 Python 3 生态展开，没有特殊兼容需求时，不需要再安装 Python 2。

从哪里下载最稳妥

建议优先从 Python 官网下载安装包：

• 官网主页：https://www.python.org/
• 下载页：https://www.python.org/downloads/

如果只是跟着教程入门，直接选择官网推荐的稳定版本即可，不必执着于某个具体小版本号。

Windows 安装步骤

1. 下载 Windows 安装包

打开 Python 官网下载页，选择适合当前系统的 Windows installer。常见情况下，直接下载 64-bit 安装包即可。 https://www.python.org/downloads/windows/ image.png

2. 运行安装程序

双击安装包后，先勾选下面这个选项：

Add python.exe to PATH

这个步骤很关键。勾选后，系统会自动把 Python 加入环境变量，后面就可以直接在命令行中使用 python 和 pip。

然后点击：

Install Now

如果你希望自定义安装目录，也可以选择 Customize installation，但对大多数入门场景来说，默认安装就足够了。

3. 验证是否安装成功

安装完成后，打开 PowerShell 或命令提示符，执行：

python --version

如果能看到版本号，说明 Python 已安装成功。

再检查 pip：

pip --version

如果这两个命令都能正常输出，说明核心环境已经准备完成。

4. 没有识别到 python 命令怎么办

如果终端提示找不到 python，通常是环境变量没有生效。可以按下面的顺序排查：

1. 重新打开终端后再试一次。
2. 检查安装时是否勾选了 Add python.exe to PATH。
3. 在系统环境变量中确认 Python 安装目录是否已经加入 Path。

常见需要加入的目录类似下面两项：

C:\Users\你的用户名\AppData\Local\Programs\Python\Python3x\
C:\Users\你的用户名\AppData\Local\Programs\Python\Python3x\Scripts\

配置完成后重新打开终端，再次执行：

python --version
pip --version

macOS 安装步骤

1. 下载并安装

进入 Python 官网下载页，选择适合 macOS 的安装包，下载后按照安装向导完成安装即可。

在较新的 macOS 环境中，系统通常更推荐使用 python3 命令，因此安装完成后优先执行：

python3 --version
pip3 --version

如果命令输出正常，说明安装成功。

2. 处理命令名差异

在 macOS 上，python 不一定指向你刚安装的 Python 3，因此建议记住这两个习惯：

• 使用 python3 代替 python
• 使用 pip3 代替 pip

这样更稳妥，也能避免和系统自带环境混淆。

推荐的安装后检查项

完成安装后，建议顺手做一次最小验证，避免后面写代码时才发现环境有问题。

检查解释器

python --version

如果是 macOS，请优先执行：

python3 --version

检查包管理器

pip --version

如果是 macOS，请优先执行：

pip3 --version

运行一个最简单的脚本

新建一个 hello.py 文件，写入以下内容：

print("Hello, Python!")

然后在终端中执行：

python hello.py

如果是 macOS：

python3 hello.py

看到输出内容后，就说明 Python 环境已经可以正常运行脚本了。

PyCharm 基础使用

如果你不想直接在命令行里写代码，可以使用 PyCharm 作为开发工具。

1. 下载 PyCharm

推荐从 JetBrains 官网下载：

• 官网：https://www.jetbrains.com/pycharm/

学习阶段使用社区版通常就够了。

2. 创建第一个项目

安装完成后，新建项目时注意检查两项：

1. 项目解释器是否指向刚安装的 Python 3。
2. 项目环境是否为新的虚拟环境，或者明确使用系统解释器。

如果解释器选错了，后面即使代码没问题，也可能出现运行失败或找不到依赖的问题。

3. 运行第一个 Python 文件

在项目中创建 main.py：

print("Python environment is ready.")

点击运行按钮后，如果控制台正常输出内容，就说明 IDE 和解释器已经正确关联。

常见问题

为什么安装成功了，但命令还是不能用

通常是以下原因之一：

• 终端没有重新打开，环境变量还没刷新
• 安装时没有勾选 Add python.exe to PATH
• Path 中缺少 Python 主目录或 Scripts 目录

应该安装多个 Python 版本吗

入门阶段不建议。先把一个稳定的 Python 3 环境跑通，比同时维护多个版本更重要。只有在特定项目存在版本约束时，再考虑使用多版本管理工具。

一定要装 PyCharm 吗

不是必须。只要 Python 和 pip 正常可用，就已经具备基础开发能力。PyCharm 的价值在于更友好的代码补全、调试和项目管理。

总结

Python 安装本身并不复杂，真正容易出问题的地方主要有两个：

• 安装时忘记加入环境变量
• 安装后没有立即验证 python / pip 是否可用

只要按本文的顺序执行，先安装、再校验、最后运行一个最小脚本，通常就能快速搭好可用的 Python 开发环境。

参考资料

• 原始参考文章：https://blog.csdn.net/sensen_kiss/article/details/141940274
• Python 官网：https://www.python.org/
• PyCharm 官网：https://www.jetbrains.com/pycharm/