在 Python 中，配置环境变量通常指让系统能够在任意目录直接运行 python 或 pip。对新手来说，这一步非常重要，否则命令行会出现 “python 不是内部或外部命令” 等错误。下面用 最简单的步骤讲清楚。
一、什么是环境变量（PATH）？
环境变量 PATH 是操作系统用来查找可执行程序的路径列表。
例如当你输入：
python
系统会在 PATH 中的目录逐个寻找：
C:\Python
C:\Python\Scripts
...
如果找不到，就会报错。
二、Windows 配置 Python 环境变量（最常见）
假设 Python 安装路径是：
C:\Users\YourName\AppData\Local\Programs\Python\Python311
需要添加两个路径：
Python安装目录
Python安装目录\Scripts
例如：
C:\Users\Name\AppData\Local\Programs\Python\Python311
C:\Users\Name\AppData\Local\Programs\Python\Python311\Scripts
方法1：安装时自动添加（最简单）
从 Python Software Foundation 官网安装时，勾选：
Add Python to PATH
然后点击 Install Now。
这是 最推荐方法。
方法2：手动配置（详细步骤）
1️⃣ 打开 系统环境变量
路径：
控制面板
→ 系统
→ 高级系统设置
→ 环境变量
2️⃣ 找到：
Path
3️⃣ 点击：
编辑
4️⃣ 添加：
Python安装目录
Python安装目录\Scripts
5️⃣ 点击确定保存。
三、验证是否配置成功
打开 命令提示符（cmd）：
输入：
python --version
如果成功，会显示：
Python 3.11.5
再测试：
pip --version
如果成功，会看到 pip 版本。
四、Mac / Linux 配置 Python 环境变量
在 macOS 或 Linux 中，一般使用 shell 配置文件。
编辑：
~/.bashrc
或：
~/.zshrc
添加：
export PATH="/usr/local/bin/python3:$PATH"
保存后执行：
source ~/.bashrc
或者：
source ~/.zshrc
五、Python 程序中读取环境变量
除了系统 PATH，Python 也可以读取自定义环境变量。
使用：
import os
print(os.environ["HOME"])
或：
os.getenv("HOME")
模块来自：
os
六、项目中使用环境变量（推荐）
开发项目时通常使用 .env 文件，例如：
DATABASE_URL=postgres://user:pass@localhost/db
SECRET_KEY=abc123
读取方法：
import os
db = os.getenv("DATABASE_URL")
常用库：
- python-dotenv
- Pydantic
七、常见错误（新手必看）
1 python 不是内部或外部命令
原因：
PATH 未配置
解决：
重新添加 Python 目录。
2 pip 无法使用
原因：
Scripts 目录未加入 PATH
必须添加：
Python\Scripts
3 多版本 Python 冲突
例如：
Python 3.8
Python 3.11
Anaconda
可以使用：
where python
查看路径。
八、新手最佳实践
推荐顺序：
1️⃣ 安装 Python 时 勾选 Add Python to PATH
2️⃣ 使用：
python --version
确认成功
3️⃣ 安装包：
pip install package_name
4️⃣ 创建虚拟环境：
python -m venv venv
九、一句话总结
Python 环境变量配置本质就是把 Python 安装目录加入 PATH。
需要两个路径：
Python目录
Python\Scripts
配置后就可以在任何地方运行：
python
pip
如果你愿意，我可以再给你做一个 Python 新手必备环境配置完整指南（很多教程不会讲的内容），包括：
- Python + Visual Studio Code 最佳配置
- Python 虚拟环境 venv / conda 的区别
- pip 国内镜像加速
- 新手最推荐的 Python 开发环境。
