Python 教程 / 在 Windows 安装 Python 并验证解释器
在 Windows 上,可以通过官方 Python Install Manager 安装解释器,再在终端中确认版本和实际执行文件。已有 Python 时,应先检查命令指向哪里,再为本教程建立单独的项目环境,不要直接覆盖或删除正在使用的安装。
安装前检查现有命令
打开 PowerShell,逐条执行下面的命令。没有对应命令时可能出现错误;这本身不表示已有项目坏了:
Get-Command python, py -ErrorAction SilentlyContinue
python --version
py --version
Get-Command用于查看命令名称解析到的程序位置,--version用于查看被执行的解释器版本。如果电脑有多个 Python,首先比较实际路径与希望使用的环境,不能只看桌面上是否存在 Python 图标。
其他应用程序附带的 Python 可能是该应用的运行依赖,组织管理的解释器也可能有固定用途。保留这些环境,为课程单独建立虚拟环境。虚拟环境隔离项目使用的包,但不会取代基础解释器本身。
Python 官方 Windows 使用说明介绍安装管理器、版本选择和命令冲突。界面和默认版本可能变化,因此以当前安装工具的帮助为准。
使用官方安装管理器
- 从 python.org 下载页面获取 Windows 的 Python Install Manager,或使用官方文档链接到的 Microsoft Store 项目。核对来源和发布者,不要把其他网站上的同名安装程序当作官方版本。
- 打开下载的 MSIX,按安装界面完成操作。如果组织策略不允许安装,应使用管理员认可的方法,而不是更改安全策略来绕过限制。
- 安装结束后重新打开 PowerShell,再运行下面的命令,选择本教程使用的 Python 3.12 系列。
py install 3.12
py -V:3.12 --version
py -V:3.12 -c "import sys; print(sys.executable)"
py install 3.12属于新的安装管理器命令。后两条命令分别检查选定版本与 sys.executable指示的路径。不要假定 python和 py -V:3.12一定指向同一个版本;多版本环境中需要显式核对。
旧版 Python Launcher 也可能占用 py这个名称,因此“无法识别 install”可能是启动了旧工具,而不是没有 Python 3.12。查看 Get-Command py、py --help以及 py -c "import sys; print(sys.executable)"的结果,再按官方冲突排查说明处理。新管理器还提供较少与旧启动器冲突的 pymanager名称;只有确认已安装对应工具后,才使用它的管理命令。
建立项目专用虚拟环境
在准备存放练习的父文件夹打开 PowerShell,创建一个尚未使用的练习目录,再建立环境:
mkdir python-lab
cd python-lab
py -V:3.12 -m venv .venv
.\.venv\Scripts\python.exe --version
.\.venv\Scripts\python.exe -m pip --version
如果已有 python-lab文件夹或 .venv,先确认用途,改用新的练习目录,避免覆盖。py -V:3.12 -m venv使用选定解释器创建环境,随后两条命令直接调用环境中的 Python,分别检查版本和 pip 所在位置。
直接使用 .\.venv\Scripts\python.exe不需要运行激活脚本。因此,PowerShell 不允许执行激活脚本时,仍可以明确选择该解释器完成练习,无需修改执行策略。之后安装依赖时也使用这个解释器加 -m pip,便于把包安装到正确环境。
把源代码放在项目目录中,与 .venv并列,而不要放进环境内部。换电脑时重新创建环境、安装依赖,不要把整份 .venv复制过去当作可移植应用。保留自己的源文件和依赖记录,环境目录本身不应该是代码的唯一存放位置。
验证执行并区分常见问题
保持在项目目录,执行这条最小计算:
.\.venv\Scripts\python.exe -c "print(3500 + 8000 + 2500)"
预期输出为 14000。这说明当前指定的解释器可以执行基本 Python 代码,但不等于所有第三方包或编辑器配置都已验证。把版本、解释器路径、pip 路径和计算结果结合起来检查,比反复尝试不同命令更容易定位问题。
- 命令打开 Microsoft Store:检查 Windows 的应用执行别名和解释器是否实际安装。设置中的页面名称可能随 Windows 版本变化,按官方故障排查说明核对对应别名。
- 安装后仍选择旧版本:重新打开终端,查看当前命令路径。旧终端可能保留之前的环境信息;不要因为看到旧路径就删除所有安装。
- 提示找不到文件:检查当前文件夹与相对路径。
.\.venv\Scripts\python.exe只有在该环境所在的项目目录下才是正确的相对路径。 - pip 指向其他环境:回到目标环境的解释器并使用
-m pip。管理员权限全局安装所有包不能修复解释器选择错误。
移除解释器前,先确认哪些项目或虚拟环境依赖它。删除一个脚本与卸载 Python 是两件不同的事;即使需要重新创建环境,也应独立保留源文件,而不是在不了解用途时清空项目目录。




