Python 环境搭建与安装配置完整指南
本文详细介绍 Python 环境的下载、安装、环境变量配置、多版本管理以及开发工具推荐,并补充虚拟环境配置与常见错误排查方法,帮助开发者快速构建稳定的 Python 运行环境。
一、下载 Python
1. 访问官网
进入 Python 官方下载页面。在下载页面可以看到很多不同版本的下载链接。其中,标记 x86 的为 32 位安装包,x86-64 为 64 位安装包。executable installer 为完整的安装包,下载完即可安装;web-based installer 体积更小,但安装时仍需联网下载其他部分。一般网络不好时选择 executable installer,以保证安装过程不会中断。
2. 确定操作系统位数
操作系统的位数可通过以下操作确定:右击此电脑 -> 点击属性 -> 查看系统类型。建议优先选择 64 位版本以获得更好的性能支持。
3. 版本选择
Python 包括 Python 2 和 Python 3 两个大版本。目前 Python 2 已停止维护,强烈建议使用 Python 3。但需注意,版本也不是越高越好,因为有的模块(库)可能不支持太高版本的 Python。对于初学者或新项目,推荐使用最新的稳定版(如 3.9+)。
二、安装 Python
- 开始安装:打开安装包所在文件夹,双击开始安装。
- 配置路径:勾选 "Add Python to PATH" 复选框,这将自动将 Python 添加到系统环境变量中,避免后续手动配置。然后点击 "Customize installation"。
- 功能选择:保持默认设置,点击 "Next"。建议选择 "Install launcher for all users" 和 "Add Python to environment variables"。
- 修改路径:可以修改安装路径(记住此路径,后面可能会用到),可以是任意空间充足的盘(例如 D 盘)。点击 "Install" 开始安装。
- 验证安装:安装完成后,同时按 "Windows+R" -> 输入 "cmd" -> 点击确定打开命令行。输入
python --version或python,若出现版本号信息,表明安装成功。
三、环境变量配置
命令行在查找可执行文件时,先在当前目录找,如果找不到,就会在 Path 变量指定的目录找。因此,确保可执行文件的路径添加到 Path 中,可以保证在任意路径都能执行程序。
1. 手动配置步骤
如果安装时未勾选自动添加,需手动配置:
- 右击此电脑 -> 单击属性。
- 点击左侧的 "高级系统设置"。
- 点击 "环境变量"。
- 在 "系统变量" 区域选中 "Path" -> 单击 "编辑"。
- 新建条目,粘贴 Python 的安装路径(例如
C:\Python39\)。 - 同样需要添加 Scripts 目录(例如
C:\Python39\Scripts\),以便使用 pip 命令。 - 点击确定保存。
2. 注意事项
- 微软商店冲突:有时候配置了环境变量,在命令行输入 "python" 会弹出微软商店。解决办法是将 python 的路径上移到微软商店前面。
- 用户变量 vs 系统变量:用户变量是对单一用户生效,系统变量对所有用户生效。如果电脑设置了多个用户,建议设置系统变量。
3. Pip 环境变量配置
pip 是 Python 的包管理工具。如果提示 pip 不是内部或外部命令,同样可以通过配置环境变量解决。确保 Scripts 文件夹路径已加入 Path。
四、Python 多版本共存配置
由于特殊需要,我们可能要在一台电脑安装多个版本的 Python。例如同时保留 Python 2.7 用于旧项目,Python 3.x 用于新开发。


