PAYATHON 2026

Python 初学者如何在 Windows 10 上安装 Python 并运行简单脚本?

技术老齐

安装好 Python 解释器后,在命令提示符中运行 python hello.py 就能执行脚本。如果出现 python not recognized,说明当前终端找不到 python 命令。常见原因是安装未成功、安装目录没有加入 PATH,或安装后没有重新打开终端。

如果已经从 Microsoft Store 安装过 Python,先检查能否运行,不必急着重装。

1. 检查 Python 是否可用

按 Win + R,输入 cmd,回车打开“命令提示符”,执行:

python --version

如果输出以 Python 3. 开头的版本信息,说明命令可用,可以直接跳到运行脚本的步骤。

如果提示无法识别命令,再试:

py --version

py 是 Windows 上启动 Python 的另一种命令,是否可用取决于安装方式。如果它能显示 Python 3 的版本,后续就可以用 py hello.py 运行脚本。

两个命令都不可用,或输入 python 后只打开了 Microsoft Store 时,继续检查安装和配置。

2. 安装 Python

可以继续使用 Microsoft Store 提供的 Python,也可以从 Python 官网的 Windows 下载页面下载安装程序。选择明确支持 Windows 10、符合电脑处理器架构的 Python 3 安装包。如果课程指定了版本,就按课程要求选择。

以下步骤适用于带有相应选项的传统 Windows 安装程序,其他安装方式的界面可能不同:

  1. 运行安装程序。
  2. 如果看到 Add python.exe to PATH 或类似选项,勾选它。
  3. 选择 Install Now,等待安装完成。

PATH 是 Windows 查找命令时使用的目录列表。将 Python 的安装目录加入其中,终端才能通过 python 找到解释器。

安装完成后,关闭原来的命令提示符,打开一个新窗口,执行:

python --version

如果用的是编辑器内置的终端,必要时也要关闭并重新打开编辑器,让它读取更新后的环境变量。

3. 仍然提示找不到命令时,检查什么?

安装时没有勾选 PATH

如果使用传统安装程序,可以重新运行对应的安装程序,在修改选项中查找将 Python 添加到环境变量的设置。具体名称因安装程序而异。

也可以手动配置:

  1. 找到实际安装的 python.exe 所在文件夹。
  2. 在 Windows 搜索中打开“编辑账户的环境变量”。
  3. 编辑用户变量中的 Path,新增该文件夹的完整路径。
  4. 保存后,重新打开命令提示符。

加入 Path 的应当是包含 python.exe 的文件夹,而非 python.exe 文件本身。请使用自己电脑上的实际安装路径,不要照抄其他电脑的路径。

如果 py 可用,可以用下面的命令查看它启动的解释器位置:

py -c "import sys; print(sys.executable)"

输入 python 后跳转到 Microsoft Store

Windows 的“应用执行别名”可能影响 python 命令。在开始菜单搜索“应用执行别名”,检查 python.exe 和 python3.exe 对应的条目。

如果准备使用从官网安装的解释器,但 python 命令被指向 Microsoft Store 的占位别名接管,可以关闭对应的占位别名,再确认实际安装目录已经加入 PATH。如果用的是 Store 版 Python,则应检查其对应别名是否启用。

在命令提示符中执行:

where python

这个命令会列出匹配到的命令路径。如果有多个结果,检查终端找到的是否是你准备使用的 Python。如果只出现 WindowsApps 路径,还需要结合应用执行别名判断,不能仅凭这条路径认定安装失败。

4. 创建并运行 Hello World 脚本

打开记事本,输入:

print("Hello World")

选择“另存为”:

  • 文件名填写 hello.py。
  • “保存类型”选择“所有文件”。
  • 编码选择 UTF-8。
  • 保存到容易找到的文件夹。

在资源管理器中打开这个文件夹,在地址栏输入 cmd,然后回车。这样打开的命令提示符会直接位于脚本所在目录。

执行:

python hello.py

如果前面只有 py 命令可用,则执行:

py hello.py

正常情况下会看到:

Hello World

命令中的 python 或 py 用来启动解释器,hello.py 是交给解释器执行的文件。

5. 初学者容易遇到的几个问题

  • 文件实际叫 hello.py.txt:在资源管理器的“查看”中勾选“文件扩展名”,确认文件以 .py 结尾。
  • 出现 can't open file 或 No such file or directory:先执行 dir,检查当前目录下是否有 hello.py,并核对文件名拼写。
  • 窗口里显示 >>>:说明已经进入 Python 交互环境,可以直接输入 print("Hello World")。要执行 python hello.py,先输入 exit() 返回命令提示符。
  • 双击脚本后窗口一闪而过:程序可能已经执行结束。通过命令提示符运行,输出会保留在窗口里。

运行这个示例只需要 Python 和一个文本编辑器,无需安装第三方库。

备注:内容仅供参考。