Python 官方下载与 PATH 配置:Windows 一步步装好并能用命令行
想学 Python、跑脚本或者用自动化工具,第一步都是把这门语言装好。很多新手卡在「装完了但命令行用不了 python 命令」这一步,多半是因为安装时漏勾了一个选项。其实只要认准官网、勾对一项,十分钟内就能装好并验证。本文按官方安装流程整理,附 PATH 手动配置和常见报错解法。
Python 官方下载入口
Python 的官方下载地址是 python.org,进入 Downloads 页面后会自动识别你的系统,Windows 用户能看到 Windows installer (64-bit) 等选项,点击即可下载 .exe 安装包。macOS 下载的是 .pkg,Linux 一般用系统包管理器安装,本文以 Windows 为例。
官网页面同时列有当前最新稳定版与历史版本。对一般学习和开发来说,直接下载首页推荐的最新稳定版即可;如果你有兼容性要求(比如依赖的库还不支持最新版),可以到 Previous releases 页面选择更早的稳定版本。不要在第三方下载站搜「Python 中文版」,那些站点捆绑的安装包来源不明,认准 python.org 最稳妥。
安装时最关键的一步:勾选 Add python.exe to PATH
运行下载好的安装程序,第一屏会看到两个核心选项:Install Now(立即安装)和 Customize installation(自定义安装)。无论选哪个,第一屏底部的「Add python.exe to PATH」复选框一定要勾上。
这一项的作用是把 Python 的安装目录自动写进系统环境变量 PATH,之后在任何目录打开命令行,输入 python 都能直接调用。漏勾的话,命令行会提示「'python' 不是内部或外部命令」,装完等于白装。
推荐流程:勾选 Add python.exe to PATH 后,先点 Customize installation 进入自定义页,保持默认组件勾选,再在高级选项页把「Install for all users」勾上(避免权限问题),安装路径可以改到非系统盘(如 D:\Python)。然后点 Install 完成安装。
验证安装:python --version
安装完成后按 Win+R 输入 cmd 打开命令行,输入:
python --version
如果输出版本号(形如 Python 3.14.x),说明安装成功且 PATH 配置正确。再试输入:
pip --version
pip 是 Python 自带的包管理工具,能输出版本号说明环境完整。如果 python 命令不被识别,而安装时确实勾选了 PATH,先重启命令行窗口再试;仍不行就按下一节手动配置。
PATH 没配好?手动加进去
安装时漏勾 PATH、或想确认路径是否正确的,可以手动配置:右键「此电脑」→「属性」→「高级系统设置」→「环境变量」,在「用户变量」或「系统变量」中找到 Path 变量,点击「编辑」→「新建」,把 Python 安装目录和它的 Scripts 子目录两项加进去:
- Python 安装目录,例如 D:\Python\(里面应有 python.exe)
- 该目录下的 Scripts 子目录,例如 D:\Python\Scripts(pip 命令所在位置)
点确定保存后,重新打开命令行输入 python --version 验证。注意配置的是安装包实际的目录,别照抄示例路径。确认 python 和 pip 都能用后,环境就完整了。
常用环境配置与验证清单
装好解释器后,很多项目会要求「虚拟环境」隔离依赖。Python 自带 venv 模块,在项目目录执行 python -m venv .venv 即可创建,再运行 .venv\Scripts\activate 激活(Windows 下)。这样每个项目装自己的包,互不污染,推荐从一开始就养成习惯。
| 检查项 | 命令 | 预期结果 | |--------|------|---------| | Python 版本 | python --version | 输出版本号 | | pip 可用 | pip --version | 输出版本号 | | 交互式环境 | python | 进入 >>> 提示符 | | 虚拟环境创建 | python -m venv .venv | 生成 .venv 目录 | | 用 pip 装包 | pip install 包名 | 安装成功提示 |
常见报错与处理
问:提示「python 不是内部或外部命令」?答:检查安装时是否勾选 Add python.exe to PATH,或按上文手动配置 Path 变量,完成后重开命令行。问:想用 py 命令代替 python?答:新版安装包会同时注册 py 启动器,命令行输入 py --version 通常也能用;若提示未找到,检查安装时是否勾选了 py launcher 组件。问:pip 下载慢或报网络错误?答:可以配置国内镜像源,具体以官方文档说明为准,一般不涉及「本站提供」任何安装内容。问:这台机器以后要跑哪些别的语言工具?可以参考站内 Node.js 的 LTS 选择文章——Windows 上多语言环境共存的 PATH 管理思路是相通的。问:不同项目需要的 Python 版本不同怎么办?答:可以用官方支持的版本管理方式在同一台机器上共存多个解释器,具体以官方文档说明为准,避免手动改 PATH 造成混乱,先保证当前这套环境干净可用。
如果你打算用 Python 写代码,编辑器推荐 VS Code,装上 Python 扩展即可获得补全和调试;相关配置方法见站内 VS Code 安装与设置文章。
装完做这几件确认
- [ ] 安装包来自 python.org,安装时已勾选 Add python.exe to PATH
- [ ] cmd 中 python --version 与 pip --version 均正常输出版本号
- [ ] 确认安装目录在预期位置(如非系统盘),且 Scripts 目录存在
- [ ] 新建虚拟环境测试:python -m venv .venv 且能激活
- [ ] 用 pip 成功安装一个包(如 requests)验证网络与 pip 正常