欢迎访问 怎么用cmd运行python文件|技术社区 | www.xservx.com

怎么用cmd运行python文件|Python新手入门指南

零基础也能学会:从安装Python到用cmd运行.py文件的全流程详解

一、安装Python:运行前的必要准备

在使用cmd运行Python文件前,必须确保系统已正确安装Python。以下是详细安装步骤与注意事项:

1.1 下载Python安装包

访问 Python官网下载页,推荐选择最新稳定版(如Python 3.12.x或Python 3.11.x)。注意区分:Windows x86-64 executable installer适用于64位系统,Windows x86 executable installer适用于32位系统。

1.2 安装过程关键配置

安装时务必勾选底部两个选项:

  • ✓ Add Python to PATH(将Python添加到环境变量)——这是避免后续“'python' 不是内部或外部命令”的关键
  • ✓ Install launcher for all users(为所有用户安装启动器)

点击 Customize installation 可进入高级配置,但对新手建议直接使用 Install Now。

1.3 验证安装是否成功

打开cmd(开始菜单搜索“cmd”→回车),输入以下命令:

python --version

若输出类似 Python 3.12.2,表示安装成功。若提示“'python' 不是内部或外部命令”,说明未添加PATH,请继续阅读环境变量部分。

⚠️ 注意:部分系统可能需使用 py 命令而非 python。输入 py --version 可验证Python启动器是否可用。

二、用cmd运行Python文件的完整流程

假设已创建文件 hello.py,内容如下:

print("Hello, World!")
name = input("请输入您的姓名:")
print(f"你好,{name}!欢迎学习Python!")

下面分步演示如何在cmd中运行它:

2.1 打开目标文件所在目录

方法一:右键文件夹 → 在终端中打开(需启用Windows终端功能);
方法二:手动导航:

cd /d D:\projects\python

说明:/d 参数用于切换盘符(如从C盘切换到D盘),若当前已在目标盘可省略。

2.2 执行Python脚本

输入以下命令之一:

python hello.py

或(若安装了Python启动器):

py hello.py

运行后将出现交互提示,输入姓名即可看到完整输出:

Hello, World!
请输入您的姓名:张三
你好,张三!欢迎学习Python!

2.3 交互式运行与非交互式运行

区别在于是否等待用户输入:

  • 非交互式:仅执行不依赖输入的代码(如数学计算、文件处理),适合自动化任务
  • 交互式:含 input() 的脚本必须在终端中运行,否则会卡住

若需在无用户干预下运行交互式脚本,可使用重定向输入:

echo 张三 | python hello.py

此命令将自动输入“张三”作为姓名,避免手动输入。

2.4 调试运行:添加verbose模式

添加 -v 参数可查看详细导入过程:

python -v hello.py

输出将包含模块加载细节,对排查依赖问题有帮助。生产环境建议移除该参数以提升性能。

三、常见错误及解决方案(附真实案例)

根据技术社区统计,以下为新手最常遇到的5类错误,按出现频率排序:

权限错误
语法错误
路径错误
编码问题
依赖缺失

3.1 权限错误(Access Denied)

现象:PermissionError: [Errno 13] Permission denied

常见于尝试写入系统目录(如C:\Program Files\)或文件被占用时。解决方案:

  • 以管理员身份运行cmd(开始菜单→搜索cmd→右键→以管理员身份运行)
  • 避免将项目放在系统目录,改用用户目录(如D:\projects)
  • 检查文件是否被其他程序锁定(如Excel打开的.csv文件)

真实案例:某用户将脚本保存在C:\Windows\System32下,运行时提示权限错误。解决方案:新建用户目录 D:\python_scripts 并移入文件后正常运行。

3.2 语法错误(SyntaxError)

现象:File "hello.py", line 3 SyntaxError: invalid syntax

通常因缩进错误、缺少冒号或括号不匹配导致。示例修复:

# 错误写法
if name == "admin"
    print("Welcome")
# 正确写法
if name == "admin":
    print("Welcome")

建议使用 VS Code 或 PyCharm 等IDE,具备实时语法高亮与错误提示。

3.3 路径错误(FileNotFoundError)

现象:FileNotFoundError: [Errno 2] No such file or directory

原因:cmd当前目录与脚本文件位置不匹配。验证方法:

dir  # 查看当前目录文件列表
cd   # 显示当前路径

解决方案:

  • 使用绝对路径:python D:\projects\python\hello.py
  • 使用相对路径(需确保当前目录正确):python .\hello.py
  • 用 pushd 命令切换目录:pushd D:\projects\python

3.4 编码问题(UnicodeDecodeError)

现象:UnicodeDecodeError: 'gbk' codec can't decode byte 0x80

原因:Windows默认使用GBK编码,而Python文件保存为UTF-8。解决方案:

  1. 在文件开头添加编码声明:# -*- coding: utf-8 -*-
  2. 用支持UTF-8的编辑器保存文件(VS Code默认UTF-8)
  3. 运行时指定编码:python -X utf8 hello.py(Python 3.7+)

3.5 依赖缺失(ModuleNotFoundError)

现象:ModuleNotFoundError: No module named 'requests'

说明脚本依赖第三方库。解决方案:

pip install requests

若提示 pip 不是内部或外部命令,请先安装pip或使用:python -m pip install requests

四、路径问题深度解析

路径是新手最易混淆的概念,以下分层详解:

4.1 绝对路径 vs 相对路径

类型示例特点
绝对路径C:\Users\Alice\hello.py从根目录开始的完整路径
相对路径.\script\hello.py相对于当前工作目录的路径

注意:. 表示当前目录,.. 表示上级目录,~ 在Windows中无效(Linux/macOS中表示用户目录)。

4.2 路径中的特殊符号处理

路径含空格或中文时,需用引号包裹:

python "D:\我的文档\项目\hello.py"

或改用短路径名(8.3格式),如 C:\PROGRA~1\Python\python.exe,但不推荐。

4.3 环境变量PATH的作用

当输入 python 时,系统按PATH顺序查找可执行文件。可通过以下命令查看:

echo %PATH%

若输出含 C:\Python312\,则说明Python已添加到PATH。添加新路径方法:

  • 临时添加:set PATH=%PATH%;D:\python(仅当前会话有效)
  • 永久添加:系统属性→环境变量→编辑PATH→新增路径

五、环境变量配置进阶

正确配置环境变量可避免90%的“命令未找到”问题。以下是详细步骤:

5.1 检查当前PATH

在cmd中执行:

echo %PATH%

搜索输出中是否含 python 或 Scripts 目录(如 C:\Users\Alice\AppData\Local\Programs\Python\Python312\Scripts)。

5.2 手动添加Python路径

步骤:
① 打开系统属性(Win+R→输入 sysdm.cpl→回车)
② 高级→环境变量
③ 在“用户变量”或“系统变量”中找到PATH→编辑
④ 新增以下路径(示例):
C:\Python312\
C:\Python312\Scripts\

完成后需重启cmd生效。

5.3 验证pip可用性

安装第三方包前,确认pip是否可用:

pip --version

若返回pip版本信息,说明配置成功。否则使用:
python -m ensurepip --upgrade
python -m pip install --upgrade pip

六、实战案例:从零到一完成完整流程

案例目标:创建一个计算BMI指数的Python脚本,并用cmd运行。

6.1 编写脚本内容

新建文本文件,重命名为 bmi_calculator.py,内容如下:

#!/usr/bin/env python
# -*- coding: utf-8 -*-
def calculate_bmi(weight, height):
    """计算BMI指数"""
    if height <= 0:
        raise ValueError("身高必须大于0")
    return round(weight / (height ** 2), 2)
def main():
    print("=== BMI指数计算器 ===")
    try:
        weight = float(input("请输入体重(kg):"))
        height = float(input("请输入身高(m):"))
        bmi = calculate_bmi(weight, height)
        print(f"\n您的BMI指数为:{bmi}")
        # BMI分类标准(WHO)
        if bmi < 18.5:
            category = "偏瘦"
        elif bmi < 24:
            category = "正常"
        elif bmi < 28:
            category = "超重"
        else:
            category = "肥胖"
        print(f"健康评估:{category}")
        print("\n参考标准:")
        print("  18.5 ≤ BMI < 24:正常范围")
        print("  BMI < 18.5:体重过轻")
        print("  BMI ≥ 24:超重风险")
    except ValueError as e:
        print(f"输入错误:{e}")
    except ZeroDivisionError:
        print("身高不能为0!")
if __name__ == "__main__":
    main()

保存后,确保文件编码为UTF-8(VS Code右下角可切换编码)。

6.2 在cmd中运行脚本

步骤:
① 打开cmd
② 切换到文件所在目录:cd D:\projects\bmi
③ 运行脚本:python bmi_calculator.py
④ 按提示输入数据:

请输入体重(kg):65.5
请输入身高(m):1.72
⑤ 输出结果:
您的BMI指数为:22.13
健康评估:正常
参考标准:
  18.5 ≤ BMI < 24:正常范围
  BMI < 18.5:体重过轻
  BMI ≥ 24:超重风险

6.3 打包为可执行文件(进阶)

使用PyInstaller可将脚本转为.exe文件:

pip install pyinstaller
pyinstaller --onefile bmi_calculator.py

生成的exe位于 dist/ 目录,双击即可运行,无需安装Python。

八、FAQ:高频问题解答

Q1:为什么输入python提示“不是内部或外部命令”?

A:未将Python添加到PATH。解决方案:
① 重新安装Python并勾选“Add to PATH”
② 手动配置环境变量
③ 使用py命令替代python

Q2:脚本运行后窗口立即关闭怎么办?

A:在代码末尾添加 input("按回车退出..."),或使用命令:
cmd /k python hello.py(/k 参数保持窗口打开)

Q3:如何让Python脚本双击直接运行?

A:方法一:关联.py扩展名(安装Python时自动完成)
方法二:用PyInstaller打包为.exe
方法三:创建bat文件包装(见7.3节)

Q4:Python 2和Python 3如何切换?

A:若同时安装两个版本:
python2 --version 或 py -2 --version
python3 --version 或 py -3 --version
默认 python 指向最新安装的版本。