命令行怎么运行Python脚本文件

顾星河
顾星河
发布时间:2026-11-20| 8人浏览过
原创

详细介绍在Windows、macOS与Linux系统命令行终端中运行Python脚本文件的具体操作步骤、路径定位方法、传参与重定向技巧,以及常见报错的排查排解。

很多初学者在编辑器中写好 Python 代码后,准备脱离开发工具直接在系统中执行,却经常卡在“打开了黑色窗口但不知道输什么”或者“提示不是内部或外部命令”。在命令行中运行 Python 脚本,核心操作其实只有明确的两件事:打开系统的终端窗口,然后通过 python 脚本文件路径 这条命令通知系统中的 Python 解释器去读取并执行代码。掌握这一技能,不仅是自动化脚本执行的基础,也是后续在服务器部署程序、运行定时任务的必备前提。

一、准备工作:确认环境与测试文件

在尝试运行具体脚本之前,需要先确认你的操作系统已经正确安装了 Python,并且终端程序能够识别 python 命令。此外,准备一个结构清晰的测试脚本能帮助你排除代码本身的逻辑错误。

1. 检查 Python 是否安装成功

打开系统终端后,输入以下命令检查当前系统的 Python 版本:

python --version

在 macOS 或部分 Linux 发行版中,系统默认的别名可能是 python3,请相应输入:

python3 --version

若终端正确返回了类似以下示例的版本号,说明环境准备就绪:

Python 3.11.5

2. 创建一个标准测试脚本

用纯文本编辑器(如记事本、VS Code、Sublime Text)新建一个文件,写入两行基础代码,并将其保存为 hello.py(例如存放在桌面的 demo 文件夹下):

# hello.py
print("Hello, Python!")
print("命令行脚本执行成功。")
命令行怎么运行Python脚本文件
图 1:命令行启动 Python 脚本从终端指令到运行时标准输出的交互架构

二、核心操作:命令行运行脚本的标准步骤

运行 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 解释器执行文件中的指令,屏幕上紧接着打印出代码中定义的内容:

Hello, Python! 命令行脚本执行成功。
命令行怎么运行Python脚本文件
图 2:命令行运行 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脚本文件
图 3:命令行运行 Python 常见故障分类与对症排查决策模型

常见错误一:“'python' 不是内部或外部命令”或“command not found”

原因:操作系统在环境变量 PATH 所记录的系统目录中找不到名为 python 的可执行程序。

解决方法:

  1. Windows 启动器替代法:Windows 安装包自带 py 启动器。你可以直接在命令行尝试输入 py hello.py。只要安装时选择了注册启动器,通常无需配置 PATH 即可直接运行。
  2. 修复环境变量:重新运行 Python 安装包,在安装向导首页勾选 “Add python.exe to PATH”,并选择 Customize installation -> Repair(修复)。
  3. 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脚本文件
图 4:命令行运行 Python 核心技能矩阵与最佳实践速查图

通过掌握以上这些命令行调用方式与排错思路,无论是在本地开发调试、编写批处理脚本,还是在远程服务器自动化部署程序,你都能够游刃有余地让 Python 脚本精准运行。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。