命令行怎么运行Python脚本文件
详细介绍在Windows、macOS与Linux系统命令行终端中运行Python脚本文件的具体操作步骤、路径定位方法、传参与重定向技巧,以及常见报错的排查排解。
很多初学者在编辑器中写好 Python 代码后,准备脱离开发工具直接在系统中执行,却经常卡在“打开了黑色窗口但不知道输什么”或者“提示不是内部或外部命令”。在命令行中运行 Python 脚本,核心操作其实只有明确的两件事:打开系统的终端窗口,然后通过 python 脚本文件路径 这条命令通知系统中的 Python 解释器去读取并执行代码。掌握这一技能,不仅是自动化脚本执行的基础,也是后续在服务器部署程序、运行定时任务的必备前提。
一、准备工作:确认环境与测试文件
在尝试运行具体脚本之前,需要先确认你的操作系统已经正确安装了 Python,并且终端程序能够识别 python 命令。此外,准备一个结构清晰的测试脚本能帮助你排除代码本身的逻辑错误。
1. 检查 Python 是否安装成功
打开系统终端后,输入以下命令检查当前系统的 Python 版本:
python --version
在 macOS 或部分 Linux 发行版中,系统默认的别名可能是 python3,请相应输入:
python3 --version
若终端正确返回了类似以下示例的版本号,说明环境准备就绪:
2. 创建一个标准测试脚本
用纯文本编辑器(如记事本、VS Code、Sublime Text)新建一个文件,写入两行基础代码,并将其保存为 hello.py(例如存放在桌面的 demo 文件夹下):
# hello.py
print("Hello, Python!")
print("命令行脚本执行成功。")
二、核心操作:命令行运行脚本的标准步骤
运行 Python 脚本的最稳妥方式遵循“打开终端 -> 切换路径 -> 执行命令”的三步法则。只要终端当前的工作目录(Working Directory)和你的脚本文件在同一个地方,就可以直接通过文件名执行。
步骤一:打开命令行终端
- Windows 系统:按下快捷键
Win + R,输入cmd或powershell并回车;也可以在桌面或文件夹空白处右键选择“在终端中打开”。 - macOS 系统:按下快捷键
Command + 空格打开聚焦搜索(Spotlight),输入Terminal或终端并按回车打开。 - Linux 系统:使用快捷键
Ctrl + Alt + T即可迅速呼出终端。
步骤二:使用 cd 命令切换到脚本所在目录
终端默认打开的位置通常是当前用户的主目录(如 C:\Users\Username 或 /Users/username)。如果你的脚本存放在其他文件夹,必须先使用 cd(Change Directory)命令进入目标路径。
例如,若你的脚本存放在桌面下的 demo 文件夹:
# Windows 系统示例
cd C:\Users\YourName\Desktop\demo
# macOS / Linux 系统示例
cd /Users/YourName/Desktop/demo
实用小技巧:在 Windows 资源管理器或 macOS 访达中打开脚本所在的文件夹,直接把文件夹拖拽到终端窗口中,终端会自动填入该目录的完整绝对路径,省去手动输入的繁琐。
步骤三:输入运行命令
确认终端提示符前缀已经显示为目标目录后,输入 python 加空格以及文件名即可执行:
python hello.py
如果使用的是 macOS 或 Linux,且默认 python 指向 Python 2,应使用 python3:
python3 hello.py
按回车键后,终端将立即调用 Python 解释器执行文件中的指令,屏幕上紧接着打印出代码中定义的内容:
补充技巧:无需 cd,直接使用绝对路径运行
如果不想先用 cd 切换目录,你也可以直接在 python 命令后面跟上该脚本的完整绝对路径。无论终端当前停留在哪个路径下,系统都能找到文件并执行:
# Windows 系统下直接运行完整路径
python C:\Users\YourName\Desktop\demo\hello.py
# macOS / Linux 系统下直接运行完整路径
python3 /Users/YourName/Desktop/demo/hello.py
如果文件路径中包含空格(例如 My Documents 或 Python Project),务必给路径两侧加上双引号,以防终端将其解析为多个独立的参数:
python "C:\Users\YourName\My Documents\hello.py"
三、进阶用法:参数传递与输出控制
命令行运行脚本不仅仅局限于简单触发,还可以向脚本传递动态参数,或者将运行结果保存至日志文件中。
1. 向 Python 脚本传递命令行参数
在脚本名称后面空格并跟上参数,例如传递用户名或文件名:
python process.py data.csv --mode=fast
在 Python 代码中,可以通过内置的 sys.argv 列表直接读取这些参数(sys.argv[0] 为脚本文件名本身,sys.argv[1] 开始为具体参数):
# process.py 示例
import sys
print(f"执行脚本名称: {sys.argv[0]}")
if len(sys.argv) > 1:
print(f"第一个参数: {sys.argv[1]}")
2. 将终端输出重定向到文件
如果在执行批处理脚本或爬虫程序时产生大量输出,可以使用 > 符号将原本打印在屏幕上的内容写入文件保存:
# 覆盖写入 output.txt
python task.py > output.txt
# 追加写入 log.txt
python task.py >> log.txt
四、常见报错与排查决策树
在实际操作中,命令行运行失败通常集中在环境变量配置、文件路径拼写以及版本别名这几个核心环节。对照以下决策逻辑,可以迅速定位并排解问题。
常见错误一:“'python' 不是内部或外部命令”或“command not found”
原因:操作系统在环境变量 PATH 所记录的系统目录中找不到名为 python 的可执行程序。
解决方法:
- Windows 启动器替代法:Windows 安装包自带
py启动器。你可以直接在命令行尝试输入py hello.py。只要安装时选择了注册启动器,通常无需配置 PATH 即可直接运行。 - 修复环境变量:重新运行 Python 安装包,在安装向导首页勾选 “Add python.exe to PATH”,并选择 Customize installation -> Repair(修复)。
- macOS/Linux 命令别名:在 macOS 和主流 Linux 中,默认预装或通过包管理器安装的通常绑定在
python3命令下,直接改用python3 hello.py即可。
常见错误二:“No such file or directory”
原因:终端当前所在的工作目录与脚本文件所在的物理位置不匹配,或者输入的文件名有误。
解决方法:
- 在 Windows 终端中输入
dir,在 macOS / Linux 终端输入ls,查看列出的文件列表中是否真正包含你的.py文件。 - Windows 系统默认可能隐藏了“已知文件扩展名”,你保存的文件看起来是
hello.py,实际文件名可能是hello.py.txt。可以在文件资源管理器中开启“文件扩展名”查看并重命名。
五、全景总结与速查对照
熟练掌握命令行运行 Python 文件,只需牢记常用命令与平台差异。下表汇总了不同环境下的核心指令:
| 操作场景 | Windows 命令行 (CMD / PowerShell) | macOS / Linux 终端 (Bash / Zsh) |
|---|---|---|
| 检查 Python 版本 | python --version 或 py --version |
python3 --version |
| 切换盘符与目录 | cd /d D:\workspace |
cd ~/workspace |
| 运行同目录下脚本 | python script.py 或 py script.py |
python3 script.py |
| 带完整路径运行 | python "D:\path\to\script.py" |
python3 "/path/to/script.py" |
| 带参数运行 | python script.py arg1 arg2 |
python3 script.py arg1 arg2 |
| 重定向输出至文件 | python script.py > output.log |
python3 script.py > output.log |
通过掌握以上这些命令行调用方式与排错思路,无论是在本地开发调试、编写批处理脚本,还是在远程服务器自动化部署程序,你都能够游刃有余地让 Python 脚本精准运行。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













