前言
配置环境变量是开发环境搭建的基础环节。掌握它，能让你的 Python 开发流程更顺畅。环境变量本质上是操作系统提供的一组动态值，用于存储系统信息、用户偏好及程序运行所需的配置。对于 Python 而言，最核心的两个变量是 PATH 和 PYTHONPATH。
PATH 决定了系统在何处查找可执行文件（如 python.exe），而 PYTHONPATH 则指定了 Python 解释器搜索模块的额外路径。虽然现代 Python 版本通常能自动处理标准库路径，但理解并正确配置它们仍是排查导入错误的关键。
Windows 系统配置
在 Windows 上操作相对直观，主要通过图形界面完成。
首先确认 Python 的安装位置。默认情况下，它可能位于 C:\PythonXX（XX 为版本号）或 C:\Users\用户名\AppData\Local\Programs\Python\PythonXX。找到这个目录后，右键点击'此电脑'选择'属性'，进入'高级系统设置'，然后点击'环境变量'。
在'系统变量'区域找到名为 PATH 的项，选中并点击'编辑'。你需要将 Python 的安装目录和 Scripts 目录添加进去，例如：
C:\Python39
C:\Python39\Scripts
注意，Windows 中多个路径之间使用分号 ; 分隔。如果之前没有配置过，确保不要删除原有的系统路径，否则可能导致其他命令失效。
关于 PYTHONPATH，除非你有特殊的自定义模块需要加载，否则一般不需要手动创建。若确实需要，可以在'系统变量'中新建一个名为 PYTHONPATH 的变量，填入模块路径即可。
macOS 和 Linux 系统配置
在类 Unix 系统上，我们需要通过终端修改配置文件来生效环境变量。
打开终端，使用文本编辑器编辑 shell 配置文件。对于大多数发行版，通常是 ~/.bash_profile 或 ~/.bashrc；macOS Catalina 及以上版本默认使用 zsh，可能需要编辑 ~/.zshrc。
以 bash 为例，执行以下命令打开文件：
nano ~/.bash_profile
在文件末尾追加以下内容，根据你的实际安装路径调整：
export PATH="/usr/local/bin/python3:$PATH"
export PYTHONPATH="/usr/local/lib/python3.9/site-packages:$PYTHONPATH"
保存退出后，为了让配置立即生效，需要重新加载配置文件：
source ~/.bash_profile
如果是 zsh 用户，请对应执行 source ~/.zshrc。
验证与常见问题
配置完成后，务必进行验证，避免后续开发踩坑。
- 检查 PATH：在命令行输入
echo $PATH（Windows 下为echo %PATH%）。你应该能在输出中看到 Python 的安装路径。接着尝试运行python --version或python3 --version，若能显示版本号，说明可执行文件已识别。 - 检查 PYTHONPATH：输入
echo $PYTHONPATH查看是否包含预期的模块路径。
