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

Python 安装与环境配置详细教程

综述由AI生成Python 安装与环境配置详细教程涵盖了从官网下载、系统安装、环境变量配置到多版本管理及开发工具选择的完整流程。重点讲解了 Windows 环境下如何正确设置 Path 变量以确保 python 和 pip 命令可用,并提供了多版本管理方案及虚拟环境使用方法。此外还对比了不同编辑器的特点,帮助开发者快速搭建 Python 编程环境并解决常见安装报错问题。

信号故障发布于 2025/2/7更新于 2026/6/520 浏览
Python 安装与环境配置详细教程

Python 安装与环境配置详细教程

本文旨在为开发者提供一份详尽的 Python 环境搭建指南,涵盖从下载、安装、环境变量配置到多版本管理及开发工具选择的全过程。无论您是初学者还是希望优化现有环境的资深用户,本教程都将帮助您快速搭建稳定可靠的 Python 编程环境。

一、下载 Python

1. 访问官网

请前往 Python 官方网站 (python.org) 下载最新版本。避免使用第三方下载站,以确保软件的安全性和完整性。

2. 版本选择

在下载页面中,您会看到多个版本的安装包:

  • 版本号:建议选择最新的稳定版(如 Python 3.x),除非有特定项目依赖旧版本。
  • 架构:x86 代表 32 位系统,x86-64 代表 64 位系统。现代电脑通常为 64 位。
  • 安装方式:
    • Windows installer (64-bit):包含完整安装程序,推荐大多数用户使用。
    • Web-based installer:体积较小,但安装时需要联网下载组件,网络不稳定时建议选前者。

3. 确认系统位数

在 Windows 系统中,可通过以下方式确认系统位数:

  1. 右键点击'此电脑'或'我的电脑'。
  2. 选择'属性'。
  3. 查看'系统类型',通常显示为'64 位操作系统'。

二、安装 Python

1. 开始安装

双击下载好的 .exe 安装包启动安装向导。

2. 关键设置

在安装界面底部,务必勾选 "Add Python to PATH" 选项。这一步至关重要,它会自动将 Python 的可执行文件路径添加到系统的环境变量中,避免后续手动配置的麻烦。

3. 自定义安装

如果未勾选上述选项,建议选择 "Customize installation" 进行自定义安装:

  1. 保持默认设置,点击 "Next"。
  2. 修改安装路径(例如 D:\Python39),确保磁盘空间充足且路径不包含中文或特殊字符。
  3. 点击 "Install" 开始安装。

4. 验证安装

安装完成后,打开命令提示符(CMD):

  1. 按 Win + R,输入 cmd,回车。
  2. 输入 python --version 并回车。
  3. 若显示类似 Python 3.x.x 的版本信息,说明安装成功。

三、环境变量配置

如果安装时未勾选 "Add Python to PATH",或者安装后无法识别 python 命令,需要手动配置环境变量。

1. 打开环境变量设置

  1. 右键点击'此电脑' -> '属性' -> '高级系统设置'。
  2. 点击'环境变量'按钮。

2. 编辑 Path 变量

  1. 在'系统变量'区域找到 Path,选中并点击'编辑'。
  2. 点击'新建',添加 Python 的安装目录,例如:D:\Python39\。
  3. 再次点击'新建',添加 Scripts 目录,例如:D:\Python39\Scripts\。这有助于 pip 命令的正常使用。
  4. 点击'确定'保存所有设置。

3. 注意事项

  • 优先级问题:如果命令行输入 python 弹出微软商店,说明系统优先匹配了商店应用。请将 Python 的路径移动到列表顶部。
  • 用户变量 vs 系统变量:用户变量仅对当前登录用户生效,系统变量对所有用户生效。建议设置为系统变量以便多用户共享。
  • 四、Pip 包管理配置

    pip 是 Python 的包管理工具,用于安装第三方库。

    1. 检查 Pip

    在命令行输入 pip --version。如果报错,说明 pip 未正确配置环境变量,请参考上一节补充 Scripts 目录路径。

    2. 更新 Pip

    建议使用最新版本的 pip 以获得更好的兼容性:

    python -m pip install --upgrade pip
    

    3. 国内镜像源加速

    由于网络原因,直接连接官方源可能较慢。可临时指定国内镜像源:

    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 库名
    

    或在配置文件中永久设置镜像源。

    五、Python 多版本共存

    有时需要在同一台电脑上运行不同版本的 Python(如 Python 2.7 和 Python 3.x)。

    1. 使用 py 启动器(推荐)

    Windows 安装程序通常会安装 py.exe 启动器。可以通过以下命令指定版本:

    py -2 script.py   # 运行 Python 2
    py -3 script.py   # 运行 Python 3
    

    2. 重命名可执行文件

    另一种方法是将不同版本的 python.exe 重命名为区分名称(如 python3, python2),并在环境变量中添加对应路径。这样在命令行直接输入 python3 即可进入对应版本。

    六、虚拟环境管理

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

    1. 创建虚拟环境

    在项目目录下执行:

    python -m venv myenv
    

    这将创建一个名为 myenv 的隔离文件夹。

    2. 激活虚拟环境

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

    激活成功后,命令行前缀会显示 (myenv)。

    3. 退出虚拟环境

    输入 deactivate 即可退出。

    七、开发工具推荐

    选择合适的编辑器能显著提升开发效率。

    1. VS Code

    轻量级、插件丰富、跨平台。适合大多数 Python 开发场景,配合 Python 插件体验极佳。

    2. PyCharm

    功能强大的专业 IDE,内置调试、重构、数据库管理等高级功能。分为社区版(免费)和专业版(付费),适合大型项目开发。

    3. Jupyter Notebook

    基于浏览器的交互式计算环境,适合数据科学、机器学习原型开发及教学演示。通过 pip install jupyter 安装。

    八、常见问题排查

    1. Command 'python' is not recognized

      • 检查是否勾选了 "Add Python to PATH"。
      • 重新配置环境变量,确保路径正确。
      • 重启终端或电脑使环境变量生效。
    2. pip 权限错误

      • 尝试使用管理员身份运行命令行。
      • 使用 --user 参数:pip install --user 库名。
    3. SSL 证书错误

      • 升级 pip 和 setuptools:python -m pip install --upgrade pip setuptools。
      • 检查系统时间是否准确。

    九、Mac/Linux 简要说明

    对于 macOS 和 Linux 用户,系统通常预装了 Python 2,建议安装 Python 3。

    • macOS:推荐使用 Homebrew 安装 brew install python3。
    • Linux:可使用包管理器,如 sudo apt-get install python3。
    • 注意:请勿卸载系统自带的 Python,以免破坏系统工具。

    通过以上步骤,您应该已经成功搭建了完整的 Python 开发环境。接下来可以开始编写代码,探索 Python 丰富的生态系统了。

    目录

    1. Python 安装与环境配置详细教程
    2. 一、下载 Python
    3. 1. 访问官网
    4. 2. 版本选择
    5. 3. 确认系统位数
    6. 二、安装 Python
    7. 1. 开始安装
    8. 2. 关键设置
    9. 3. 自定义安装
    10. 4. 验证安装
    11. 三、环境变量配置
    12. 1. 打开环境变量设置
    13. 2. 编辑 Path 变量
    14. 3. 注意事项
    15. 四、Pip 包管理配置
    16. 1. 检查 Pip
    17. 2. 更新 Pip
    18. 3. 国内镜像源加速
    19. 五、Python 多版本共存
    20. 1. 使用 py 启动器(推荐)
    21. 2. 重命名可执行文件
    22. 六、虚拟环境管理
    23. 1. 创建虚拟环境
    24. 2. 激活虚拟环境
    25. 3. 退出虚拟环境
    26. 七、开发工具推荐
    27. 1. VS Code
    28. 2. PyCharm
    29. 3. Jupyter Notebook
    30. 八、常见问题排查
    31. 九、Mac/Linux 简要说明
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • 使用 MybatisPlus 将百度天气数据持久化至 PostgreSQL
    • Linux 线程概念详解
    • 为什么当前 AI 大模型主要基于 Python 开发
    • 当大模型成为新一代操作系统,我们如何转型 AI 产品经理?
    • 2026 年 3 月全球 AI 前沿动态与技术突破
    • C++ list 模拟实现:带头双向链表的增删查改
    • Spatial Joy 2025 全球 AR&AI 赛事:开发者资源与参赛指南
    • AI 实践:工具函数调用(Function Calling)实战指南
    • Python PyQt6 桌面应用开发实战指南
    • Windows11 VMware 17.6.0 更新 Tools 报错无法连接服务器解决方案
    • 滑动窗口算法核心思路与四道经典题解
    • 基于 LangChain 实现的知识库问答工具
    • 从 vw/vh 到 clamp():前端响应式设计的痛点与进化
    • 根据设计图生成前端代码,零基础入门到精通,收藏这篇就够了
    • 机器人系统设计核心:从架构拆解到工程落地实践
    • SQL Prompt 工具介绍与正版使用建议
    • 具身智能深度解析:深度视觉如何赋予足式机器人跑酷能力
    • Photoshop 集成 ComfyUI AI 绘画功能指南
    • LeetCode 88:合并两个有序数组(C 语言双指针详解)
    • Windows 本地运行 DeepSeek 的 3 个简单步骤

    相关免费在线工具

    • 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