一、安装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。解决方案:
- 在文件开头添加编码声明:
# -*- coding: utf-8 -*- - 用支持UTF-8的编辑器保存文件(VS Code默认UTF-8)
- 运行时指定编码:
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 指向最新安装的版本。