在自动化任务开发场景中,Python凭借丰富的第三方库和简洁的语法成为很多开发者的首选语言,但不少人在运行自动化脚本时会遇到系统无法识别Python命令的问题,核心原因就是没有正确配置Python环境变量。环境变量可以让系统在任何目录下都能找到Python可执行文件,无需切换到Python安装目录就能直接运行脚本。

Windows系统配置Python环境变量
Windows系统的环境变量配置分为安装时自动配置和手动配置两种情况。
安装时自动配置
在运行Python安装包时,勾选安装界面底部的Add Python to PATH选项,安装程序会自动将Python的安装路径和Scripts路径添加到系统环境变量中,适合新手操作。
手动配置步骤
如果安装时未勾选自动添加选项,可以按照以下步骤手动配置:
- 找到Python的安装路径,默认路径一般为
C:Users用户名AppDataLocalProgramsPythonPython3xx,同时记录该路径下的Scripts文件夹路径 - 右键点击桌面此电脑,选择属性,点击高级系统设置
- 在弹出的系统属性窗口中点击环境变量按钮
- 在系统变量区域找到Path变量,点击编辑
- 点击新建,分别添加Python安装路径和Scripts路径,点击确定保存所有设置
macOS系统配置Python环境变量
macOS系统自带Python2版本,若需要配置自行安装的Python3环境变量,操作如下:
首先打开终端,输入以下命令查看Python3的安装路径:
which python3
假设输出的路径为/usr/local/bin/python3,对应的安装目录一般为/usr/local/Cellar/python@3.xx/3.xx.x/bin(使用Homebrew安装的情况),然后编辑shell配置文件:
如果使用bash shell,编辑~/.bash_profile文件:
# 打开配置文件 vi ~/.bash_profile # 在文件末尾添加以下内容,替换为实际路径 export PATH="/usr/local/Cellar/python@3.xx/3.xx.x/bin:$PATH" # 保存退出后执行以下命令生效 source ~/.bash_profile
如果使用zsh shell,编辑~/.zshrc文件,操作同上,最后执行source ~/.zshrc生效。
Linux系统配置Python环境变量
Linux系统的配置逻辑和macOS类似,以Ubuntu系统为例:
先查看Python3的安装路径:
which python3
假设路径为/usr/bin/python3,对应的安装目录为/usr/bin,编辑~/.bashrc文件:
vi ~/.bashrc # 在文件末尾添加 export PATH="/usr/bin:$PATH" # 保存后执行 source ~/.bashrc
如果是需要所有用户都能使用,可以编辑/etc/profile文件,添加同样的路径配置,执行source /etc/profile生效。
验证配置是否生效
配置完成后打开新的终端(Windows需要重启终端或者重启电脑让配置生效),输入以下命令验证:
# 查看Python版本 python --version # 或者 python3 --version # 查看pip版本,pip是Python包管理工具,用于安装自动化脚本依赖的库 pip --version
如果命令能正常输出对应的版本号,说明环境变量配置成功。
常见问题解答
- 配置后还是提示找不到Python命令:检查添加的路径是否正确,Windows系统需要确认Path变量中是否包含了Python安装目录和Scripts目录,修改配置后需要重启终端再测试
- 多个Python版本冲突:可以在配置环境变量时指定具体版本的路径,运行脚本时使用
python3 脚本名.py而不是python 脚本名.py来区分版本 - pip命令找不到:检查Python的Scripts目录是否添加到环境变量中,pip一般存放在该目录下
自动化脚本中的路径注意事项
配置好Python环境变量后,运行自动化脚本时如果涉及到文件路径,建议使用绝对路径或者基于脚本所在目录的相对路径,避免因为工作目录变化导致文件读取失败,以下是获取脚本所在目录的Python代码示例:
import os
# 获取当前脚本所在的绝对目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 拼接脚本所在目录下的配置文件路径
config_path = os.path.join(script_dir, "config.ini")
print(f"配置文件路径为:{config_path}")