前言
在使用 Python 时，正确配置环境变量是非常重要的一步。环境变量可以帮助 Python 找到可执行文件和库文件，确保你的 Python 程序能够正常运行。
一、什么是环境变量？
环境变量是操作系统提供的一种动态值的集合，用于存储系统信息、用户偏好设置以及程序运行所需的配置信息。对于 Python，最核心的环境变量是 PYTHONPATH 和 PATH。PYTHONPATH 用于指定 Python 模块的搜索路径，而 PATH 用于让系统知道在哪里可以找到 Python 的可执行文件。
二、配置环境变量
1. Windows 系统
步骤 1：找到 Python 安装路径
通常，Python 安装在 C:\PythonXX（XX 为版本号）或 C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX。
步骤 2：打开系统属性
右键点击'此电脑'或'计算机'，选择'属性' > '高级系统设置'。
步骤 3：打开环境变量设置
在'系统属性'窗口中，点击'环境变量'按钮。
步骤 4：配置 PATH 环境变量
在'系统变量'中找到名为 PATH 的变量，点击'编辑'。在'变量值'中添加 Python 的安装路径和脚本路径，例如：
C:\Python39;C:\Python39\Scripts
每个路径之间用分号 ; 分隔。
步骤 5：配置 PYTHONPATH 环境变量
在'系统变量'中点击'新建'，创建一个新的变量 PYTHONPATH，并添加你的 Python 模块路径，例如：
C:\Python39\Lib;C:\Python39\DLLs
每个路径之间用分号 ; 分隔。
2. macOS 和 Linux 系统
步骤 1：打开终端
打开终端应用程序。
步骤 2：编辑配置文件
使用文本编辑器（如 nano 或 vim）编辑配置文件。对于 macOS 和大多数 Linux 发行版，编辑 ~/.bash_profile 或 ~/.bashrc 文件：
nano ~/.bash_profile
或
nano ~/.bashrc
步骤 3：添加 Python 路径
在文件的末尾添加以下内容：
export PATH="/usr/local/bin/python3:$PATH"
export PYTHONPATH="/usr/local/lib/python3.9/site-packages:$PYTHONPATH"
根据你的 Python 安装路径进行调整。
步骤 4：保存并应用配置
保存文件后，运行以下命令使配置立即生效：
source ~/.bash_profile
或
source ~/.bashrc
三、验证环境变量配置
1. 验证 PATH 环境变量
在命令行或终端中输入以下命令来验证 PATH 环境变量是否包含 Python 路径：
echo $PATH
（在 Windows 系统中，使用 echo %PATH%）
你应该能看到 Python 的安装路径和脚本路径。
2. 验证 PYTHONPATH 环境变量
在命令行或终端中输入以下命令来验证 PYTHONPATH 环境变量：
echo $PYTHONPATH
（在 Windows 系统中，使用 echo %PYTHONPATH%）
你应该能看到 Python 模块的路径。
3. 测试 Python 命令
在命令行或终端中输入以下命令来测试 Python 命令是否可以正常运行：
python --version
或
python3 --version
你应该能看到 Python 的版本号。
四、常见问题及解决方法
1. 命令提示符中找不到 Python 命令
如果你在命令提示符中输入 python 或 python3 时提示'命令未找到'，可能是因为 PATH 环境变量没有正确配置。
解决方法：
- 检查
PATH环境变量是否包含 Python 的安装路径。 - 确保 Python 的安装路径和脚本路径都已添加到
PATH中。 - 重新启动命令提示符或终端，使环境变量生效。
2. 无法导入模块
如果你在运行 Python 脚本时提示'无法导入模块'，可能是因为 PYTHONPATH 环境变量没有正确配置。
解决方法：
- 检查
PYTHONPATH环境变量是否包含 Python 模块的路径。 - 确保模块路径已正确添加到
PYTHONPATH中。 - 重新启动命令提示符或终端，使环境变量生效。
五、总结
配置 Python 环境变量是确保 Python 程序能够正常运行的重要步骤。通过以上步骤，即使是小白也能轻松搞定 Python 环境变量的配置。以下是关键要点：
- Windows 系统：
- 找到 Python 安装路径。
- 打开系统属性 > 高级系统设置 > 环境变量。
- 在
PATH环境变量中添加 Python 的安装路径和脚本路径。 - 创建
PYTHONPATH环境变量并添加模块路径。
- macOS 和 Linux 系统：
- 打开终端。
- 编辑
~/.bash_profile或~/.bashrc文件。 - 在文件中添加
PATH和PYTHONPATH的配置。 - 保存文件并运行
source ~/.bash_profile或source ~/.bashrc使配置生效。
- 验证配置：
- 使用
echo $PATH和echo $PYTHONPATH验证环境变量。 - 使用
python --version或python3 --version测试 Python 命令。
- 使用
