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

在命令行中运行 Python 脚本的核心逻辑十分直接：启动操作系统的终端工具，通过路径导航或直接指定文件位置，调用 Python 解释器去解析并执行目标 .py 文本文件。掌握这一基础流程，是脱离集成开发环境黑盒、理解脚本运行机理的关键起点。

一、准备工作：确认环境与创建脚本

在执行脚本前，系统中需要已经安装 Python 环境，并且需要一个包含有效代码的 .py 源码文件。

我们首先创建一个简单的示例文件。在电脑桌面新建一个名为 code_demo 的文件夹，在其中新建文本文件并重命名为 hello.py（请确保文件后缀为 .py 而不是 .py.txt）。使用记事本或文本编辑器打开，写入以下一行代码并保存：

保存后，我们需要验证系统是否能识别 Python 指令。打开系统的终端工具：

• Windows 系统：按下键盘快捷键 Win + R，输入 cmd 或 powershell 并回车。
• macOS 系统：按下 Command + 空格键 呼出聚焦搜索，输入 Terminal（终端）并打开。
• Linux 系统：使用快捷键 Ctrl + Alt + T 打开终端。

在终端中输入版本检查命令并回车：

如果输出类似上述的版本号，说明解释器已就绪。如果在 macOS 或某些 Linux 发行版中提示未找到命令，请尝试输入 python3 --version，很多现代 Unix 系统将 Python 3 的默认指令命名为 python3。

二、核心操作：切换路径与执行脚本

命令行并不能凭空猜出你的 hello.py 放在哪里。每次打开终端时，系统都会停留在一个默认的“当前工作目录”（通常是用户主文件夹，如 C:\Users\Username 或 /Users/username）。要执行特定位置的代码，最稳妥的方法是先将工作目录切换到文件所在文件夹。

步骤 1：使用 cd 命令进入脚本所在文件夹

在终端中，输入 cd（Change Directory 的简写），后接一个空格和目标文件夹的路径。假设文件存放在桌面上的 code_demo 目录中：

输入完成后按下回车。此时终端提示符前的路径文字会发生变化，表明当前工作目录已成功切换。你可以在当前目录下输入列出文件命令（Windows 为 dir，macOS/Linux 为 ls），确认 hello.py 确实在该列表中。

步骤 2：调用解释器执行 .py 文件

确保当前目录正确后，在光标处输入：

按下回车键，系统会唤起 Python 解释器读取并执行该脚本。执行完毕后，控制台会立即输出结果并返回命令行等待光标：

三、运行原理与路径机制

初学者常遇到的疑惑是：“为什么有时候直接输入文件名可以运行，有时候却提示找不到文件？”这涉及到操作系统的寻址机制。

命令 python hello.py 本质上是由两个部分组成的指令：前半部分 python 是系统可执行程序（解释器），后半部分 hello.py 是传递给解释器的参数（目标文件）。

当参数只写 hello.py 时，操作系统默认只在当前工作目录中寻找该文件。如果你的终端当前停留在 C:\Users\Username，而文件在 code_demo 文件夹内，系统自然无法找到，从而抛出 No such file or directory 错误。

除了先用 cd 切换目录，你也可以直接传入文件的绝对路径或相对路径来执行：

四、容易混淆的常见说法辨析

围绕“如何运行 Python 脚本”，网络上流传着几种看起来合理、但实际上有严格前提或容易误导初学者的说法。我们需要结合具体场景予以辨析。

混淆说法 1：“直接双击 .py 文件就能正常运行程序”

混淆说法 2：“在所有电脑上都可以直接敲 python 命令”

五、常见报错排查与解决方法

在初次尝试命令行执行时，以下三种报错最为集中。遇到错误时请对照具体表现进行排查：

1. 报错：'python' is not recognized / command not found

原因剖析：终端程序在收到 python 命令后，会在操作系统的 PATH 环境变量所列出的所有目录中寻找名为 python.exe（或 python）的文件。如果找不到，就会提示此错误。

解决方式：

• 在 Windows 上重新运行 Python 安装包，点击“Modify”，务必勾选“Add Python to environment variables”；或在命令行尝试使用 py hello.py。
• 在 macOS 或 Linux 上，检查是否应使用 python3 hello.py。如果安装了第三方环境（如 Homebrew 或 Miniconda），请确认其 bin 目录是否已加入终端配置（如 .zshrc 或 .bashrc）。

2. 报错：No such file or directory

原因剖析：这说明 Python 解释器已经成功启动，但它在当前工作目录下没有找到指定名称的文件。常见原因包括：文件名拼写错误、漏写 .py 后缀、操作系统隐藏了已知文件扩展名导致实际文件名为 hello.py.txt，或者当前终端并没有 cd 到该文件所在的文件夹。

解决方式：

• 输入 dir（Windows）或 ls（macOS/Linux），查看列出的文件名列表中是否存在目标文件。
• 在文件资源管理器中关闭“隐藏已知文件扩展名”选项，确认文件后缀确实只是 .py。

3. 报错：SyntaxError（语法错误）

原因剖析：这说明文件已被解释器顺利加载，但代码内容不符合 Python 语法规则（例如使用了中文引号、缺少括号或缩进错乱）。

解决方式：根据报错信息中指出的具体行号（例如 line 1），用文本编辑器打开代码文件，检查该行标点符号是否为纯英文半角字符，修改并保存后再重新在命令行运行。

六、实操进阶：命令行参数与重定向输出

掌握基础运行后，命令行还提供了几项非常实用的延展能力：

1. 向脚本传递命令行参数

在执行脚本时，可以在文件名后附加参数，以空格分隔。Python 代码内部可以通过内置的 sys.argv 列表接收这些参数：

在脚本内部，sys.argv[0] 为脚本本身名称 process.py，而 sys.argv[1] 则为 input.txt。这种运行模式常用于数据批量处理和自动化运维工具开发。

2. 将脚本运行结果重定向保存到文件

如果控制台输出的内容较长，或者需要将执行结果沉淀为日志，可以利用操作系统的输出重定向符号 >：

执行该命令后，终端屏幕上不会打印任何内容，而是自动在当前目录下生成一个名为 output.log 的文本文件，记录原本应打印的所有文本。如果使用 >>，则会将新输出追加到文件末尾而不是覆盖原有内容。