Windows和Mac怎么用命令行运行Python脚本

用命令行运行 Python 脚本的核心逻辑只有两步：第一步是唤醒正确的 Python 解释器程序，第二步是将脚本文件的存储路径作为参数传给它。无论是在 Windows 还是 macOS 上，只要搞清“解释器命令叫什么”以及“终端当前处于哪个文件夹”，就能在几秒钟内完成脚本的调用与执行。

1. 运行原理与核心步骤拆解

图形化开发工具（如 PyCharm 或 VS Code）底部的“运行”按钮，实际上是在后台自动拼接了一条系统命令。通过纯命令行运行脚本并非更复杂的黑魔法，而是把这个自动化动作还原到用户眼前。

当我们在命令行中输入 python main.py 时，操作系统先在系统的全局索引（即环境变量 PATH）中查找名为 python 的可执行程序，随后通知该程序打开并逐行翻译 main.py 中的代码。因此，任何一次成功的运行，本质上都依赖三个核心节点的正确对接：可用的终端、可被调用的解释器名称，以及目标脚本的明确文件路径。

2. 确认终端与 Python 环境

在直接运行脚本文件之前，必须先确认两件事：命令行工具在哪里打开，以及系统是否能正确认出 Python 命令。

在 Windows 上：推荐使用系统自带的 PowerShell 或 命令提示符（CMD）。按下键盘上的 Win + R，在弹出的运行框中输入 powershell 并回车即可开启。在终端中输入以下指令确认版本：

python --version
# 示例输出：
Python 3.11.4

如果系统提示“'python' 不是内部或外部命令”，说明安装 Python 时未勾选“Add python.exe to PATH”。此时在 Windows 上可以尝试直接输入 py --version，因为官方安装包通常会默认写入 Python 启动器（py.exe）。

在 Mac 上：使用快捷键 Command + 空格键 调出聚焦搜索（Spotlight），输入“终端”或 Terminal 后回车。由于 macOS 历史版本中曾内置 Python 2.7，输入命令时需注意版本区分：

python3 --version
# 示例输出：
Python 3.12.1

在大多数现代 macOS 系统中，直接输入 python 往往会报错或提示需要安装开发工具，因此在 Mac 环境下请习惯性使用 python3 作为主命令。

3. 实战：运行一个简单的脚本

假设我们在桌面上新建了一个名为 hello.py 的文件，其内部写入一行简单的代码：

# hello.py
print("Hello, Python script executed successfully!")

要运行这个脚本，最标准、也是最不易引发文件读取错误的方式，是先进入脚本所在的目录，再执行文件名。因为脚本运行时，它所引用的相对路径文件通常以当前终端所在工作区为参照。

Windows 操作示范：

# 1. 切换到桌面目录
cd C:\Users\YourUsername\Desktop

# 2. 运行脚本
python hello.py

# 示例输出：
Hello, Python script executed successfully!

Mac 操作示范：

# 1. 切换到桌面目录
cd ~/Desktop

# 2. 运行脚本
python3 hello.py

# 示例输出：
Hello, Python script executed successfully!

如果不想每次手动输入 cd 路径，也可以利用终端支持“拖拽文件自动填入绝对路径”的特性：先在命令行中键入 python （注意末尾保留一个空格），然后直接用鼠标把 hello.py 文件图标拖入终端窗口，回车即可运行。这种方式在脚本深藏在多层文件夹时尤为高效。

4. 常见报错与排查路径

在实际操作中，新手最常遇到的中断并非代码本身的语法逻辑问题，而是环境定位与文件层级的异常。以下是三类核心报错及应对方案：

针对文件路径中含有空格或中文的情况，命令行经常因为将空格识别为参数分隔符而报错。例如 python my script.py 会被系统误解为“运行名为 my 的脚本，传入参数 script.py”。遇到含空格的路径，务必使用英文双引号将整个路径包裹起来：

python "C:\Users\John Doe\My Projects\main.py"

5. 总结与日常操作对照

掌握命令行运行脚本的能力，是自动化批处理、服务器部署以及多环境调试的基础。平时的操作可以提炼为下述决策矩阵：

只要理顺“目录导航 (cd)”与“命令前缀区分 (python vs python3)”这两点，命令行的交互就会变得十分透明且符合预期。在后续处理复杂工程时，结合虚拟环境（venv）同样基于这套基础逻辑演进，养成使用命令行明确调用脚本的习惯，是深入掌握开发工作流的重要起点。