Windows怎么用cmd执行python脚本

白榆
白榆
发布时间:2026-11-19| 7人浏览过
原创

深入浅出讲解在Windows命令提示符(cmd)中执行Python脚本的完整方法。包含环境核验、目录切换、全路径调用、参数传递、虚拟环境运行以及常见报错(如不是内部或外部命令、跳转应用商店、找不到文件)的排查指引。

第一步:打开 CMD 并核验 Python 运行环境

在 Windows 操作系统中,命令提示符(cmd.exe)是一个经典的文本交互界面。它并不内置运行 Python 代码的能力,而是通过调用安装在磁盘上的 Python 解释器(python.exe)来解析脚本。因此,在尝试执行脚本前,首要任务是确认解释器已正确安装并且系统能够找到它。

1. 启动命令提示符的两种简便方式

打开 cmd 窗口有两种最为直接的操作:

  • 全局快捷键调出:按下键盘上的快捷键 Win + R,在弹出的“运行”对话框中输入 cmd 并按下回车,即可打开以当前用户主目录(例如 C:\Users\用户名)为起点的终端。
  • 从文件夹地址栏直接启动(强烈推荐):如果已经通过 Windows 文件资源管理器打开了存放脚本的文件夹,可以直接鼠标点击顶部地址栏,将原本显示的路径文字清空并直接键入 cmd 按下回车。此时弹出的命令行窗口会直接定位到该文件夹下,免去了手动切换盘符和路径的麻烦。

2. 检验系统环境变量是否配置成功

在弹出的黑色终端窗口中,输入以下环境查询命令并按回车:

python --version
预期示例输出 Python 3.11.8

如果窗口输出了具体的版本号(如 Python 3.10、3.11 或 3.12),表明系统环境变量(PATH)配置无误,可以直接执行后续步骤。

如果在输入后看到提示:'python' 不是内部或外部命令,也不是可运行的程序或批处理文件,说明 Windows 在当前系统已登记的路径列表(PATH)中没有找到名为 python.exe 的文件。

此时不妨先尝试另一个 Windows 专属命令:

py --version

官方安装包在 Windows 上默认会部署一个全局启动器 py.exe(安装在 Windows 系统目录下,通常不需要额外设置 Path)。如果 py --version 能够正常回显版本,那么后文中所有使用 python 的命令都可以无缝替换为 py。

Windows怎么用cmd执行python脚本
图 1:Windows CMD 执行 Python 脚本的标准四步流程分解

第二步:执行脚本的两种核心路径模式

要在 cmd 中顺利启动 Python 脚本,关键是告诉 Python 解释器目标文件存放在磁盘的什么位置。通常有两种方式:一种是“先切换工作目录再执行”,另一种是“在任意目录下直接指定完整路径”。

模式一:使用 cd 命令切换至脚本目录再执行(推荐)

这是实际开发中最稳妥、也是最常见的操作方式。假设你的 Python 脚本名为 hello.py,存放在 D:\Projects\Demo 文件夹下:

在 cmd 中使用 cd(Change Directory)命令切换路径。特别需要注意的是:Windows 在跨磁盘盘符切换时(例如从系统盘 C: 切换到数据盘 D:),需要加上 /d 参数。如果不加 /d,只输入 cd D:\Projects\Demo,终端提示符依然会停留在 C 盘,不会真正发生跳转。

:: 跨盘符切换并进入目标目录
cd /d D:\Projects\Demo

:: 此时提示符变为 D:\Projects\Demo>,直接输入解释器与脚本文件名
python hello.py
预期示例输出 D:\Projects\Demo> python hello.py Hello, Windows CMD! 当前脚本成功执行。

为什么推荐这种模式?
因为绝大多数 Python 脚本在处理本地资源时,往往会写相对路径,例如 open('config.json') 或 pd.read_csv('data.csv')。Python 寻找相对路径文件的基准并非脚本自身所在的位置,而是启动它时 cmd 终端所处的“当前工作目录(Current Working Directory)”。先切换到脚本目录,能从源头上避免很多由相对路径解析失败引起的 FileNotFoundError 异常。

模式二:在任意位置直接传入脚本的绝对路径

如果你当前在其他目录,不想移动 cmd 的位置,也可以直接在 python 之后输入脚本的完整绝对路径:

python "D:\Projects\Demo\hello.py"
双引号规则:如果脚本存放的文件夹名称中包含空格(例如 C:\Program Files 或 D:\My Projects\app.py),在路径两端必须添加英文半角双引号。如果没有引号,cmd 会把空格作为参数分隔符,将其识别为几个互不相干的片段,从而报出无法找到文件的错误。
Windows怎么用cmd执行python脚本
图 2:切换工作目录法与全路径直执模式的工作机制与使用差异对比

第三步:Windows 专用 Python 启动器(py 命令)的用法

很多开发者在 Windows 上会同时安装多个版本的 Python(比如 Python 3.8 用于维护老旧项目,Python 3.11 用于现代项目)。在 cmd 中,如果直接输入 python,系统只会调用环境变量里排在最前方的版本。

Windows 专属的 py(Python Launcher)提供了更加优雅的多版本调度能力:

  • 列出本机安装的所有 Python 解释器:
py -0
预期示例输出 -V:3.11 * Python 3.11 (64-bit) -V:3.8 Python 3.8 (64-bit)

(带有星号 * 的为当前默认选中的版本)

  • 显式指定使用某一个版本执行当前脚本:
:: 强制使用 3.8 版本运行脚本
py -3.8 hello.py

:: 强制使用 3.11 版本运行脚本
py -3.11 hello.py

此外,py 启动器还能够读取脚本首行的 Shebang 声明(例如代码第一行写的 #!python3.9),自动匹配并启动正确的解释器版本,极大简化了多版本环境下的日常调用。

第四步:向脚本传递命令行参数与调试技巧

实际应用中的 Python 脚本往往需要接收外部输入的参数,例如待处理的文件名、运行模式开关或调试参数。cmd 执行时向脚本传参的方式非常直观:

1. 传参执行语法

只需在脚本文件名后面以空格分隔,依次写上参数即可:

python process.py input.csv output.csv --verbose

在 Python 脚本内部,可以通过标准库的 sys.argv 列表来接收这些参数。其中 sys.argv[0] 固定代表脚本本身的名称,sys.argv[1] 对应 input.csv,以此类推。

2. 检查脚本执行结果与退出状态码(ERRORLEVEL)

在编写自动化批处理脚本(.bat)或者检查长时间任务时,通常需要判断上一步的 Python 脚本是成功运行完毕,还是因为未捕获的报错意外退出。

在 cmd 中紧接着执行如下命令,可以打印上一条命令的退出状态码:

echo %ERRORLEVEL%
  • 输出为 0:表示 Python 脚本正常执行完成,没有抛出未捕获的异常。
  • 输出为 非 0(通常为 1):表示 Python 抛出了未处理的 Exception 中断退出,或者脚本内部显式调用了 sys.exit(1)。

3. 虚拟环境(venv)中的脚本运行

如果项目使用了虚拟环境隔离依赖包,在 cmd 中应该先激活该虚拟环境,然后再执行脚本:

:: 假设虚拟环境目录为 .venv
call .venv\Scripts\activate.bat

:: 此时终端提示符最前面会出现 (.venv) 标识
python main.py

:: 执行完毕后退出虚拟环境
deactivate

第五步:常见问题与排错决策指引

初次在 Windows cmd 下运行 Python 脚本时,可能会遇到几种典型的卡点。以下是具体成因与最直接的解决途径:

Windows怎么用cmd执行python脚本
图 3:Windows CMD 运行 Python 典型报错与排查决策树

1. 敲入 python 后没有运行,反而自动弹出了 Windows 应用商店?

原因:Windows 10 和 Windows 11 系统为了引导用户从 Microsoft Store 安装应用,默认开启了名为“应用执行别名”的机制。如果系统在 PATH 环境变量中找不到真实的 Python,或者环境变量顺序靠后,就会优先命中系统预设的快捷引导程序,从而打开应用商店。

解决方法:

  1. 点击 Windows“开始”菜单,搜索并打开“管理应用执行别名”(或在系统“设置” → “应用” → “高级应用设置”中找到)。
  2. 在列表中找到名为“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”的两项。
  3. 将这两项右侧的开关全部切换为“关闭”状态。
  4. 关闭现有的 cmd 窗口并重新打开一个新窗口,此时系统便不再会劫持命令跳转商店。

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

原因一(路径不匹配):cmd 当前所处的路径下根本没有这个文件。例如你在 C:\Users\Admin 目录下执行 python hello.py,而 hello.py 实际上保存在桌面上。可以通过在终端中输入 dir 查看当前目录下包含的所有文件列表。

原因二(扩展名被隐藏导致误命名):Windows 文件资源管理器默认勾选了“隐藏已知文件类型的扩展名”。许多初学者在新建文本文件并重命名为 test.py 时,系统实际保存的文件全名其实是 test.py.txt。可以在 cmd 中输入 dir test* 观察真实文件名,或在资源管理器“查看”选项卡中勾选“文件扩展名”进行纠正。

3. 为什么不能直接在文件夹里双击 .py 文件?

双击 .py 文件虽然也能启动关联的 Python 程序,但对于绝大多数控制台程序来说,代码执行完毕的一瞬间,弹出的黑框窗口就会立即自动关闭。这导致两类严重问题:一是一闪而过根本来不及看清楚脚本的输出结果;二是如果代码发生报错崩溃,Traceback 堆栈信息会随着窗口销毁而瞬间消失,根本无法排查错误。

通过在 cmd 终端中手动执行,窗口是持久常驻的。无论脚本是顺利打印了文字,还是报错中断,所有内容都会清晰完整地停留在屏幕上供你检查与调试。

总结与命令速查

掌握 cmd 执行 Python 脚本的核心在于:保持对当前路径的清晰认知、善用 Windows 专属的 py 启动器解决版本与环境痛点、通过引号规范避免路径空格问题。下表对日常最高频的命令组合进行了整理收录,可作为操作速查参考:

Windows怎么用cmd执行python脚本
图 4:Windows CMD 运行 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 算法库。