Python程序怎么运行：命令行执行.py脚本的基础步骤

第一步：打开命令行终端并确认 Python 解释器环境

运行脚本的第一项动作是唤起操作系统的命令行界面。命令行是开发者与计算机底层直接沟通的文本窗口。在不同操作系统中，打开终端的方式略有差异：

• Windows 系统：按下键盘上的 Win + R 快捷键打开“运行”窗口，输入 cmd 后回车即可打开命令提示符；或者在任务栏搜索并打开 PowerShell 或 Windows Terminal。
• macOS 系统：按下快捷键 Command + 空格键 唤起聚焦搜索（Spotlight），输入“终端”或 Terminal 并回车。
• Linux 系统：桌面环境下通常可使用全局快捷键 Ctrl + Alt + T 快速开启终端。

进入终端后，首先看到的不是代码编辑区，而是系统自身的命令提示符（例如 Windows 下类似 C:\Users\username>，macOS 下类似 username@MacBook-Pro ~ %）。在输入脚本之前，必须先核实当前系统中安装的 Python 解释器命令名称。

在终端光标处键入以下命令并敲击回车：

python --version

如果终端输出了类似上述的 Python 3.x 版本号，说明系统已成功识别 python 命令。如果提示未找到命令，或在 macOS/Linux 上输出的是较旧的 Python 2.x 版本，则应尝试输入：

python3 --version

第二步：准备并确认测试脚本文件

Python 程序文件是以 .py 为扩展名的纯文本文件。为了完整走通整个执行链条，我们准备一个结构最简单的基础测试脚本。

在电脑中选择一个便于查找的文件夹（例如在电脑的用户目录或桌面下建立一个名为 py_demo 的文件夹），使用文本编辑器（如 VS Code、Sublime Text 或系统自带的记事本）新建一个名为 hello.py 的文件，写入如下代码并保存：

# 定义消息内容
message = "Hello, Python from Command Line!"

# 在终端中打印输出
print(message)

第三步：在命令行中定位并运行脚本的两种路径

解释器需要准确知道目标文件存放的位置。在命令行中指示文件位置，主要有两种标准做法。

方式一：切换工作目录后执行（最推荐的基准做法）

这是日常开发中最标准、最不易出错的方式：首先使用操作系统的 cd（Change Directory，更改目录）命令将终端所在的“当前工作目录”（Current Working Directory, 简称 CWD）切换到脚本存放的文件夹中，随后直接用文件名调用。

假设我们的 hello.py 存放在 /Users/username/py_demo 文件夹中（Windows 用户对应类似 D:\py_demo），具体执行操作如下：

cd /Users/username/py_demo

若在 Windows 系统中且目标位于其他盘符（如从 C 盘切换到 D 盘），需在 cd 后面加上 /d 参数，或直接单独输入盘符：

cd /d D:\py_demo

切换完成后，建议先执行列出目录内容的命令（macOS/Linux 输入 ls，Windows 输入 dir），亲眼确认屏幕输出列表中确实出现了 hello.py。确认无误后，直接执行：

python hello.py

方式二：在任意目录下传入完整绝对路径或相对路径

如果在当前终端中不想变更工作目录，也可以直接将脚本的绝对路径作为参数传给解释器：

# macOS / Linux 下传入绝对路径
python3 /Users/username/py_demo/hello.py

# Windows 下传入绝对路径（若路径含空格需加英文双引号）
python "C:\Users\username\Desktop\my folder\hello.py"

如图 2 所示，之所以强烈推荐“先用 cd 切换目录”的模式一，原因在于 Python 程序的相对路径读取机制。 当你的代码中包含诸如 with open('data.txt') 这样的文件读写代码时，Python 寻找文件的起点并不是该脚本本身存放的物理位置，而是启动该 Python 进程时终端所在的工作目录。 如果不在脚本目录下执行，程序就会因为工作目录偏离而找不到同级目录下的配置文件或数据资源。因此，将终端目录提前切换到代码同级，是最稳妥的工程习惯。

第四步：向脚本传递命令行参数与执行过程剖析

在实际工作中，许多脚本需要像系统工具一样接收外部输入的指令或文件路径，而不是将参数硬编码在代码内部。命令行执行脚本的一大核心优势，就是可以极方便地在文件名后面附加参数。

在命令行语法中，紧跟在脚本文件名后面的所有用空格隔开的字符，都会被操作系统打包传送给 Python 程序。Python 标准库内置的 sys.argv 列表专门用于捕获这些外部输入。

我们新建一个名为 process.py 的文件，编写如下逻辑：

import sys

# sys.argv 是一个列表，存储所有命令行参数
print("接收到的完整参数列表:", sys.argv)

# 第 0 个元素始终是脚本文件自身的名称
script_name = sys.argv[0]
print("脚本名称:", script_name)

# 检查是否传入了外部参数
if len(sys.argv) > 1:
    target_file = sys.argv[1]
    print("目标处理文件:", target_file)
else:
    print("提示：未传入任何附加参数")

在终端中带参数运行该脚本：

python process.py sample_data.csv --mode fast

从图 3 的映射模型可以看出，Shell 会以空格为界把字符串切分为多个单元：

• sys.argv[0] 固定指向当前被调用的脚本名称（或路径）。
• 从 sys.argv[1] 开始，依次存放用户在后面追加的位置参数和选项参数。
• 类型提醒：从命令行传入的所有参数在进入 Python 后默认都是纯字符串（str）类型。如果传入的是数值（例如端口号或循环次数），必须在代码内部显式使用 int() 或 float() 完成类型转换后方可参与算术运算。

第五步：高频报错排查与“双击运行”误区辨析

在命令行执行脚本的过程中，初学者最常遇到的两类报错都有着极其明确的物理成因，无需盲目猜测：

1. “'python' 不是内部或外部命令” 或 “command not found: python”

报错根因：操作系统的底层查找机制依赖一个名为 PATH 的全局环境变量。当你在终端输入 python 时，操作系统会遍历 PATH 中记录的所有文件夹去寻找对应的可执行文件。如果该变量中没有包含 Python 的安装路径，系统就会提示找不到命令。

解决办法：Windows 用户可以通过重新运行 Python 官方安装包，选择“Modify”，并务必勾选“Add Python to environment variables”完成自动修复；或者在系统“高级系统设置”中手动将 Python 安装目录（如 C:\Users\username\AppData\Local\Programs\Python\Python3xx\）添加到用户变量的 PATH 中。macOS 与 Linux 用户则建议先执行 which python3 确认可执行文件的实际安装路径。

2. “can't open file 'xxx.py': [Errno 2] No such file or directory”

报错根因：解释器在当前终端所处的工作目录下没有找到名为 xxx.py 的文件。

解决办法：不要急于反复回车。先在终端敲击 ls（macOS/Linux）或 dir（Windows）查看当前目录下的真实文件清单。检查两点：第一，终端所在的目录是否确实是保存代码的文件夹；第二，文件名拼写是否准确，特别是检查是否存在被系统自动追加的隐藏后缀（如实际是 xxx.py.txt）。

总结：命令行执行的核心记忆法则

掌握在命令行运行 Python 脚本，是脱离集成开发环境限制、理解现代软件工程自动化部署与任务调度的基石。归纳起来，整个操作可以凝聚为简洁的三步口诀：

1. 一验环境：打开系统终端，通过 python --version 或 python3 --version 确认生效的解释器别名与安装状态；
2. 二定目录：利用 cd 命令将终端的工作路径切换到脚本存放的具体文件夹，并用目录清单命令核实文件存在；
3. 三调脚本：输入 python 文件名.py 敲击回车，在保留的终端窗口中直接阅读执行反馈或异常堆栈。

只要理清了“操作系统终端”、“Python 解释器进程”与“脚本文件物理位置”三者之间的清晰协作关系，就能在任何平台、任何服务器环境下自如执行与调度 Python 代码。