跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Python 环境安装与 Pip 配置完整指南

在 Windows 系统下安装 Python 环境的完整流程,包括从官网下载、安装时配置环境变量、验证安装状态、配置 Pip 包管理器及国内镜像源的使用。此外还补充了虚拟环境的创建方法、依赖管理及常见报错的解决方案,帮助开发者快速搭建可用的 Python 开发基础环境。

steve发布于 2025/2/7更新于 2026/9/763 浏览
Python 环境安装与 Pip 配置完整指南

Python 环境安装与 Pip 配置完整指南

前言

Python 因其简洁易读的语法和强大的生态系统,成为数据科学、人工智能、Web 开发等领域的首选语言。本指南旨在提供一份详尽的 Windows 平台 Python 安装与配置教程,涵盖从环境搭建到包管理工具 Pip 的配置,以及虚拟环境的最佳实践,帮助初学者快速构建稳定的开发环境。

一、下载 Python 安装包

  1. 访问官网:打开浏览器访问 Python 官方下载页面 https://www.python.org/downloads/。
  2. 选择版本:
    • 推荐使用最新稳定版(如 Python 3.10 或更高),以获得更好的性能和安全更新。
    • 旧版本(如 3.7)仅建议在特定兼容性需求下使用。
  3. 下载文件:
    • 64 位系统:点击 "Windows x86-64 executable installer"。
    • 32 位系统:点击 "Windows x86 executable installer"。
    • 注意:Windows XP 等老旧系统已不再支持新版 Python,建议升级操作系统。

二、安装 Python 环境

  1. 运行安装程序:双击下载的 .exe 文件启动安装向导。
  2. 配置环境变量(关键):
    • 在安装界面的第一页,务必勾选底部的 "Add Python to PATH" 复选框。
    • 此操作会将 Python 的可执行文件路径添加到系统的环境变量中,确保在任何目录下都能通过命令行调用 python 命令。
    • 若不勾选,后续需手动修改系统环境变量,过程较为繁琐且容易出错。
  3. 选择安装类型:
    • Install Now:推荐新手使用,安装到默认路径(通常为 C:\Users\用户名\AppData\Local\Programs\Python\PythonXX)。
    • Customize installation:高级用户可选择安装位置、组件(如 pip、文档、tcl/tk 库等)。
  4. 完成安装:等待进度条走完,看到 "Setup was successful" 提示即可关闭。

三、验证安装是否成功

  1. 打开命令行:
    • 按 Win + R 键,输入 cmd 并回车;或在开始菜单搜索 "PowerShell"。
  2. 检查版本:
    python --version
    
    或
    py --version
    
    若输出类似 Python 3.10.5 的版本号,说明安装成功。
  3. 测试交互模式:
    • 输入 python 回车,出现 >>> 提示符表示进入解释器。
    • 输入 print("Hello World") 回车,应输出 Hello World。
    • 输入 exit() 或按 Ctrl + Z 然后回车退出。

四、安装与配置 Pip

Pip 是 Python 的标准包管理工具,用于安装、升级和卸载第三方库。

1. 确认 Pip 状态

在命令行输入:

pip --version

若显示版本信息,说明已内置。若提示'不是内部或外部命令',请重新检查 PATH 配置或运行 python -m ensurepip --upgrade。

2. 升级 Pip

为了修复已知漏洞并获得新功能,建议定期升级:

python -m pip install --upgrade pip

若下载速度过慢,可指定国内镜像源:

python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 常用镜像源列表

  • 清华大学:https://pypi.tuna.tsinghua.edu.cn/simple/
  • 阿里云:http://mirrors.aliyun.com/pypi/simple/
  • 中国科学技术大学:https://pypi.mirrors.ustc.edu.cn/simple/
  • 豆瓣:http://pypi.douban.com/simple/

4. 安装第三方库

以安装常用的 requests 库为例:

pip install requests

安装成功后,可在 Python 代码中 import requests 使用。 查看已安装的包列表:

pip list

五、进阶配置:虚拟环境

为了避免不同项目之间的依赖冲突,强烈建议使用虚拟环境(Virtual Environment)。

1. 创建虚拟环境

在项目目录下执行:

python -m venv myenv

这将在当前目录生成一个名为 myenv 的文件夹,包含独立的 Python 解释器和包目录。

2. 激活虚拟环境

  • CMD:
    myenv\Scripts\activate.bat
    
  • PowerShell:
    myenv\Scripts\Activate.ps1
    

激活后,命令行前缀会显示 (myenv),表示当前处于该环境中。

3. 导出与导入依赖

保存当前环境的所有包:

pip freeze > requirements.txt

在其他机器恢复环境:

pip install -r requirements.txt

六、常见问题排查

  • 问题:找不到 python 命令
    • 解决:检查是否勾选了 "Add to PATH"。若已安装,请重启命令行窗口。若仍无效,需手动将 Python 安装路径(如 C:\Python310)添加到系统环境变量 Path 中。
  • 问题:权限不足 (Permission Denied)
    • 解决:尝试以管理员身份运行命令提示符,或在安装命令后添加 --user 参数(如 pip install --user xxx)。
  • 问题:SSL 证书错误
    • 解决:通常由网络代理或防火墙引起。可尝试更换镜像源,或暂时关闭安全软件。
  • 问题:pip 下载速度慢
    • 解决:务必使用国内镜像源,如上节所示。

七、推荐开发工具

安装好环境后,可以选择合适的集成开发环境(IDE)提升效率:

  1. Visual Studio Code:轻量级,插件丰富,适合 Python 开发。
  2. PyCharm:功能强大,专为 Python 设计,社区版免费。
  3. Jupyter Notebook:适合数据分析与交互式计算。

总结

通过本教程,您已成功在 Windows 系统上安装了 Python 环境并配置了 Pip 包管理器。掌握了虚拟环境的用法后,您可以更安全地管理项目依赖。接下来即可开始编写代码,探索 Python 的无限可能。

目录

  1. Python 环境安装与 Pip 配置完整指南
  2. 前言
  3. 一、下载 Python 安装包
  4. 二、安装 Python 环境
  5. 三、验证安装是否成功
  6. 四、安装与配置 Pip
  7. 1. 确认 Pip 状态
  8. 2. 升级 Pip
  9. 3. 常用镜像源列表
  10. 4. 安装第三方库
  11. 五、进阶配置:虚拟环境
  12. 1. 创建虚拟环境
  13. 2. 激活虚拟环境
  14. 3. 导出与导入依赖
  15. 六、常见问题排查
  16. 七、推荐开发工具
  17. 总结

更多推荐文章

查看全部
  • Stable Diffusion 3.5 FP8 在天气变化模拟图像中的动态表现
  • 程序员如何利用 AI 工具提升开发效率
  • Android Framework 核心机制解析:Binder、Handler 与系统启动流程
  • SQL PASS 西雅图参会:美国签证申请实战经验
  • 大语言模型微调技术详解:从原理到实践
  • 通义万相 2.1 多模态生成技术解析与应用场景
  • AIGC 产品经理的定义、职责及与 AI 产品经理的区别
  • Git 常用指令速查
  • 使用 100 行代码构建 Mini AI Agent 实战指南
  • AIGC 联动 Photoshop 与 Spine 2D 实现 2D 角色骨骼动画拆件
  • 基于 Fofa 与 Rad 的自动化漏洞扫描实战流程
  • Python 中文分词库 jieba 快速入门指南
  • 深度学习实战:卷积神经网络(CNN)原理与 LeNet-5 搭建
  • Sentence-BERT 句嵌入模型介绍与实践
  • 数据结构初阶:顺序表与链表精选 15 道 OJ 练习
  • 用 Python 模拟机场出租车调度:排队论与博弈论的结合
  • 电商策略自动化系统:结合数据采集与 AI 的分析实践
  • Flutter for OpenHarmony 通义万相 AIGC 联调与相册持久化
  • OpenClaw 钉钉机器人配置指南(macOS)
  • C++ 备忘录模式:优雅实现对象状态保存与恢复

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online