Windows 系统下 Python 环境配置及 pip 安装完整指南
1. 前言
pip 是 Python 的包管理工具,提供了对 Python 包的查找、下载、安装、卸载等功能。在 Python 3.4 和 2.7 及以上版本中,通常默认已配套安装 pip。但在某些情况下,用户可能遇到 pip 未安装或环境变量未配置的情况,导致无法使用 命令。
本文详细介绍了 Windows 系统下 Python 环境的配置流程及 pip 包管理工具的安装方法。内容涵盖如何检查 Python 和 pip 版本、配置系统环境变量 Path、通过 ensurepip 模块或 get-pip.py 脚本安装 pip、以及 pip 的常用命令操作。此外,文章还补充了权限错误、网络超时等常见问题的解决方案,并介绍了虚拟环境的创建与使用方法,旨在帮助开发者建立规范的 Python 开发环境。

pip 是 Python 的包管理工具,提供了对 Python 包的查找、下载、安装、卸载等功能。在 Python 3.4 和 2.7 及以上版本中,通常默认已配套安装 pip。但在某些情况下,用户可能遇到 pip 未安装或环境变量未配置的情况,导致无法使用 命令。
pip本教程主要针对 Windows 用户,详细介绍如何检查 Python 环境、配置系统环境变量以及安装和配置 pip 的完整流程,并补充常见问题的解决方案。
按住 Win + R 键打开运行窗口,输入 cmd 并回车,打开命令提示符窗口。
在命令提示符中输入以下命令:
pip --version
如果显示类似 pip xx.x.x from ... (python x.x) 的信息,说明 pip 已安装且配置成功。如果提示''pip'不是内部或外部命令,也不是可运行的程序或批处理文件',则需要进行后续配置。
有时安装了 Python 但未配置环境变量,导致无法调用。输入以下命令检查:
python --version
若显示版本号(如 Python 3.9.0),说明 Python 已正确配置。若同样报错,则需要配置 Python 的系统环境变量。
若上述命令报错,需手动将 Python 安装路径添加到系统 PATH 变量中。
Path 变量,选中后点击'编辑'。C:\Python39\C:\Python39\Scripts\注意:不同版本的 Python 安装路径可能不同,请根据实际安装位置填写。
配置完成后,重新打开一个新的命令提示符窗口,再次执行 python --version 和 pip --version 验证是否生效。
较新版本的 Python 自带了 ensurepip 模块,可用于初始化 pip。
在命令提示符中运行:
py -m ensurepip --upgrade
或者:
python -m ensurepip --upgrade
如果该命令执行成功,通常会看到 Successfully installed pip... 的提示。随后即可直接使用 pip 命令。
如果上述方法无效,可以手动下载 pip 安装包。
get-pip.py 脚本。D:\tools\。cd D:\tools\
python get-pip.py
Scripts 文件夹路径已添加到系统环境变量(参考第 3 节)。安装成功后,可通过以下命令验证:
pip --version
pip list
掌握以下基础命令可有效管理 Python 包:
更新 pip 自身
python -m pip install --upgrade pip
安装指定包
pip install requests
安装指定版本的包
pip install requests==2.28.1
查看已安装的包列表
pip list
查询可更新的包
pip list --outdated
更新指定包
pip install --upgrade <package_name>
卸载包
pip uninstall <package_name>
查看帮助信息
pip help
在安装包时如果遇到权限错误,可以尝试添加 --user 参数,将包安装到当前用户目录下:
pip install --user <package_name>
或者以管理员身份运行命令提示符。
国内用户在使用 pip 时可能会遇到网络连接缓慢的问题。建议配置国内镜像源加速下载。
临时使用镜像源:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package_name>
永久配置镜像源:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
如果遇到 SSL 证书验证失败,可尝试关闭 SSL 验证(不推荐用于生产环境):
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org <package_name>
为了避免不同项目之间的依赖冲突,强烈建议使用虚拟环境(Virtual Environment)。
在项目目录下运行:
python -m venv venv
venv\Scripts\activate.bat
venv\Scripts\Activate.ps1
激活后,命令行前缀会显示 (venv),此时安装的包仅在当前环境中有效。
deactivate
本文详细讲解了 Windows 环境下 Python 环境的检查、环境变量的配置、pip 的安装方法及常用命令。通过合理配置环境和使用虚拟环境,可以大幅提升开发效率并避免依赖冲突。如遇其他问题,建议查阅 Python 官方文档或社区资源获取支持。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online