杰瑞科技汇

如何在cmd中运行Python脚本?

核心概念

要明白两个关键角色:

  1. Python 解释器:这是一个程序,它能读懂并执行你写的Python代码,它就像是懂“Python语言”的翻译官。
  2. Python 脚本文件:这是一个文本文件,扩展名通常是 .py,里面写着你希望Python解释器执行的指令。

我们的目标就是:让Python解释器去读取并执行我们的脚本文件。


前提条件:确保Python已安装并配置好环境变量

在开始之前,你的电脑上必须安装了Python,并且最重要的——将Python添加到了系统的环境变量(PATH)中

如何检查?

  1. 打开命令提示符(按 Win + R,输入 cmd,回车)。
  2. 输入以下命令并回车:
    python --version

    或者

    python3 --version
  • 如果显示了版本号Python 3.10.8),恭喜你,环境变量已经配置好了!你可以跳到下一部分。
  • 如果提示 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件,说明Python没有被添加到环境变量中,你需要先去完成这一步,否则后续操作都无法进行,你可以搜索“如何将Python添加到环境变量”找到详细的教程。

第一步:创建一个简单的Python脚本

假设你已经在电脑上创建了一个文件夹来存放你的代码,D:\MyPythonScripts

  1. 用记事本、VS Code或其他任何代码编辑器,创建一个新文件。
  2. 输入下面这行简单的代码:
    print("Hello, CMD!")
    print("当前Python版本是:")
    import sys
    print(sys.version)
  3. 将这个文件保存到你的文件夹中,并命名为 hello.py确保扩展名是 .py 而不是 .txt

现在你的文件结构看起来像这样:

D:\MyPythonScripts\
└── hello.py

第二步:在CMD中运行Python脚本

打开命令提示符(CMD),现在有两种主要的方法来运行你的脚本。

使用 python 命令(最常用)

这是最直接、最推荐的方法。

  1. 切换到你的脚本所在目录 在CMD中,你需要先“进入”到 hello.py 文件所在的文件夹,使用 cd (change directory) 命令。

    # 假设你的脚本在 D:\MyPythonScripts 目录下
    cd D:\MyPythonScripts

    提示:如果路径中包含空格,需要用引号括起来,cd "My Documents"

  2. 运行脚本 现在你已经在正确的目录下了,输入 python 命令,后面跟上你的脚本文件名。

    python hello.py

    然后按回车。

  3. 查看结果 你会在CMD窗口中看到脚本的输出:

    Hello, CMD!
    当前Python版本是:
    3.10.8 (tags/v3.10.8:aaaf517, Oct 11 2025, 16:50:30) [MSC v.1929 64 bit (AMD64)]

使用绝对路径(不切换目录)

如果你不想切换目录,也可以直接提供脚本的完整路径。

  1. 确保你知道脚本的完整路径 D:\MyPythonScripts\hello.py

  2. 在CMD中直接运行 在CMD的任何位置,输入以下命令:

    python D:\MyPythonScripts\hello.py

    按回车,效果和方法一完全一样。


进阶用法:给脚本传递参数

你的Python脚本可以接收从命令行传入的参数,这在编写工具脚本时非常有用。

修改脚本以接收参数

打开 hello.py,修改它的内容如下:

# hello.py
import sys
# sys.argv 是一个列表,包含了所有从命令行传入的参数
# 第一个参数 (sys.argv[0]) 永远是脚本本身的文件名
# 第二个参数 (sys.argv[1]) 才是你传入的第一个实际参数
if len(sys.argv) > 1:
    name = sys.argv[1]  # 获取第一个参数
    print(f"你好, {name}! 欢迎使用Python!")
else:
    print("你没有提供名字,请这样运行: python hello.py 你的名字")
# 仍然打印版本号
print("\n当前Python版本是:")
import sys
print(sys.version)

在CMD中运行并传参

你可以在运行脚本时在文件名后面加上空格,然后跟上你的参数。

# 在 D:\MyPythonScripts 目录下运行
python hello.py Alice

输出结果:

你好, Alice! 欢迎使用Python!
当前Python版本是:
3.10.8 (tags/v3.10.8:aaaf517, Oct 11 2025, 16:50:30) [MSC v.1929 64 bit (AMD64)]

再试一次不带参数的运行:

python hello.py

输出结果:

你没有提供名字,请这样运行: python hello.py 你的名字
当前Python版本是:
3.10.8 (tags/v3.10.8:aaaf517, Oct 11 2025, 16:50:30) [MSC v.1929 64 bit (AMD64)]

常见问题与解决方法

  1. 问题:'python' 不是内部或外部命令...

    • 原因:Python没有添加到系统环境变量PATH中。
    • 解决:重新运行Python安装程序,在第一个界面勾选 "Add Python to PATH" 选项,然后完成安装,或者手动将Python的安装路径(C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\)添加到系统环境变量中。
  2. 问题:'python' : 无法将“python”项识别为 cmdlet、函数、脚本文件或可运行程序的名称...

    • 原因:可能你的系统中同时安装了Python 2和Python 3,或者有其他程序干扰了,可以尝试使用 py 命令,这是Python官方推荐的管理器。

    • 解决

      # 使用 py 命令,它会自动找到可用的Python版本
      py hello.py
      # 或者指定版本
      py -3 hello.py  # 强制使用Python 3
      py -2 hello.py  # 强制使用Python 2
  3. 问题:SyntaxError: (unicode error) 'utf-8' codec can't decode byte...

    • 原因:你的脚本文件保存的编码格式不是UTF-8,而CMD默认使用UTF-8读取。
    • 解决:用你的代码编辑器重新保存 hello.py 文件,选择“另存为”,然后在编码选项中选择 UTF-8
任务 CMD 命令
检查Python版本 python --version
切换到脚本目录 cd 路径\到\你的\文件夹
运行脚本 python 你的脚本.py
用绝对路径运行 python 完整\路径\到\你的脚本.py
运行脚本并传参 python 你的脚本.py 参数1 参数2

掌握在CMD中运行Python是学习自动化、脚本开发和部署应用的第一步,希望这个详细的指南能帮到你!

分享:
扫描分享到社交APP
上一篇
下一篇