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

Windows 系统 Python 详细安装教程与配置指南

Python 安装教程涵盖官网下载、环境配置、路径设置及版本验证。通过自定义安装勾选环境变量与启动器,确保开发环境可用。后续介绍常用开发工具对比及基础脚本测试方法,解决常见安装问题,帮助开发者快速搭建本地 Python 运行环境。

星河入梦发布于 2025/2/6更新于 2026/5/3123 浏览
Windows 系统 Python 详细安装教程与配置指南

Windows 系统 Python 详细安装教程与配置指南

一、Python 简介与官网资源

Python 是一种广泛使用的解释型、面向对象、动态数据类型的高级程序设计语言。其官方网站提供了丰富的资源,包括项目简介、下载中心、文档库、社区支持及成功案例等。

访问 Python 官方下载地址:https://www.python.org/

二、下载对应操作系统的安装包

  1. 打开 Python 官网,将鼠标悬停在导航栏的 Downloads 菜单上。
  2. 在下拉菜单中选择 Windows 操作系统选项。
  3. 进入 Windows 专属页面后,查看可用的发布版本。

版本选择建议

  • Stable Releases(稳定发布版):经过充分测试,适合生产环境和日常开发,推荐优先选择。
  • Pre-releases(预发布版):处于测试阶段,可能存在不稳定因素,不建议普通用户使用。

安装包类型选择

在版本列表中,主要包含以下几种安装包:

  • Windows Installer (64-bit):标准的 64 位安装程序,包含完整的开发环境(如 pip、IDLE 等),适合绝大多数现代 Windows 电脑。
  • Windows embeddable package:可嵌入包,解压即用,但不包含 pip 等扩展工具,主要用于将 Python 嵌入其他应用程序,不适合独立开发。
  • 32-bit / ARM64:根据电脑硬件架构选择。目前主流为 64 位系统,请确认系统类型后下载对应的 64-bit 版本。

三、执行安装程序与配置

双击下载的 .exe 安装文件开始安装。为了获得最佳体验,建议不要直接使用默认的 "Install Now",而是选择 Customize installation(自定义安装)。

1. 基础权限设置

在初始界面,务必勾选以下两个关键选项:

  • Add python.exe to PATH:将 Python 添加到系统环境变量 Path 中。这允许用户在命令行(CMD 或 PowerShell)的任何目录下直接输入 python 命令来运行脚本,无需指定完整路径。
  • Use admin privileges when installing py.exe:以管理员权限安装启动器,确保所有用户账户都能调用 Python。

2. 可选功能设置 (Optional Features)

点击 Customize installation 进入此界面,建议全部勾选:

  • Documentation:安装离线文档,方便查阅标准库手册。
  • pip:Python 的包管理工具,用于安装第三方库(如 requests, numpy 等)。
  • tcl/tk and IDLE:安装图形界面库 Tkinter 及 Python 自带的集成开发环境 IDLE。
  • Python test suite:标准库测试套件,用于验证安装完整性。
  • py launcher:Python 启动器,用于管理多个 Python 版本。

3. 高级选项设置 (Advanced Options)

继续点击 Next 进入高级设置,建议如下配置:

  • Associate files with Python:将 .py 文件关联到 Python 解释器,双击即可运行脚本。
  • Create shortcuts for installed applications:在开始菜单创建快捷方式。
  • Add Python to environment variables:再次确认环境变量已添加(通常上一步勾选后自动生效)。
  • Precompile standard library:预编译标准库,提升程序加载速度。
  • Customize install location:建议修改默认安装路径(如 C:\Python311),避免安装在 C 盘 Program Files 下导致权限问题,同时便于管理。
  • 完成设置后点击 Install 开始安装,等待进度条完成即可。

    四、安装验证与环境检查

    安装完成后,必须进行验证以确保环境配置正确。

    1. 打开命令行工具(Win + R 输入 cmd 回车)。
    2. 输入以下命令并回车:
      python --version
      
      若显示类似 Python 3.11.x 的版本号,说明安装成功且环境变量配置正确。
    3. 检查包管理器:
      pip --version
      
      若显示 pip 版本信息,说明包管理工具已就绪。
    4. 尝试导入标准库:
      python -c "import sys; print(sys.version)"
      
      若无报错并打印版本详情,则环境完全正常。

    五、开发工具推荐

    虽然 IDLE 随 Python 自带,但功能较为简单,适合初学者学习语法。对于实际项目开发,推荐使用专业的集成开发环境(IDE):

    • PyCharm:JetBrains 出品,功能强大,提供代码智能提示、调试、重构、数据库管理等全套功能。分为社区版(免费)和专业版(付费)。
    • VS Code:微软出品,轻量级,通过安装 Python 插件可实现强大的开发能力,支持多语言混合编程。
    • Jupyter Notebook:适合数据科学、机器学习领域的交互式编程,支持代码、文本、图表混排。

    六、常见问题排查

    1. 安装后无法识别 python 命令

      • 原因:未勾选 "Add python.exe to PATH"。
      • 解决:重新运行安装程序,选择 Modify,勾选该选项;或手动将 Python 安装目录下的 Scripts 和主目录添加到系统环境变量 Path 中。
    2. pip 安装失败

      • 原因:网络问题或权限不足。
      • 解决:尝试使用国内镜像源,例如:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 库名;或在管理员模式下运行 CMD。
    3. 权限错误 (Permission Denied)

      • 原因:试图写入受保护的系统目录。
      • 解决:尽量将 Python 安装在非系统盘(如 D 盘),并确保当前用户有读写权限。
    4. 环境变量未生效

      • 原因:修改了环境变量但未重启终端。
      • 解决:关闭所有 CMD 窗口,重新打开一个新的命令行窗口再试。

    七、编写第一个 Python 程序

    验证环境无误后,可以创建一个简单的测试脚本。

    1. 新建一个文本文件,命名为 hello.py。
    2. 输入以下内容:
      def main():
          print("Hello, Python!")
      
      if __name__ == "__main__":
          main()
      
    3. 保存文件,在命令行中进入该文件所在目录,运行:
      python hello.py
      
      若终端输出 Hello, Python!,则表明 Python 环境已完全可用。

    八、虚拟环境与多版本管理

    在实际开发中,不同项目可能需要不同版本的依赖包。建议使用虚拟环境(Virtual Environment)隔离项目依赖。

    1. 创建虚拟环境:
      python -m venv myenv
      
    2. 激活虚拟环境:
      • Windows: myenv\Scripts\activate.bat
      • Linux/Mac: source myenv/bin/activate
    3. 退出虚拟环境:
      deactivate
      

    九、卸载与清理

    如需卸载 Python,可通过控制面板的'程序和功能'找到 Python 进行卸载。卸载时建议勾选删除所有相关文件和配置,以避免残留垃圾文件影响后续安装。


    本教程涵盖了从下载到验证的全过程,旨在帮助用户建立稳定的本地 Python 开发环境。遇到具体问题时,可参考官方文档或社区资源进一步排查。

    目录

    1. Windows 系统 Python 详细安装教程与配置指南
    2. 一、Python 简介与官网资源
    3. 二、下载对应操作系统的安装包
    4. 版本选择建议
    5. 安装包类型选择
    6. 三、执行安装程序与配置
    7. 1. 基础权限设置
    8. 2. 可选功能设置 (Optional Features)
    9. 3. 高级选项设置 (Advanced Options)
    10. 四、安装验证与环境检查
    11. 五、开发工具推荐
    12. 六、常见问题排查
    13. 七、编写第一个 Python 程序
    14. 八、虚拟环境与多版本管理
    15. 九、卸载与清理
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

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

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

    更多推荐文章

    查看全部
    • WebGPU 性能调优技术解析与实践
    • VS Code C/C++ 编译与运行配置指南
    • 钉钉 AI 助手集成指南:构建智能办公机器人
    • Spring Security 安全框架核心:认证、授权与防护
    • 企业微信 Webhook 机器人 Java 集成指南
    • Vue 3 开发实战:10 个提升效率的核心技巧
    • Flutter 三方库 langchain_google 的鸿蒙化适配指南
    • Ubuntu 24.04 安装 OpenClaw 完整指南
    • ModelScope 魔搭社区介绍与大模型微调指南
    • Win11+Ubuntu 双系统彻底卸载指南:清理分区与 GRUB 引导项
    • 基于 FPGA 的 EtherCAT 主站 Verilog 设计与同步算法解析
    • 文心一言 4.5 开源评测与本地部署实践
    • 计算机专业学生成长指南:技能提升与学习路径
    • 手机端运行 Stable Diffusion 的开源方案与使用指南
    • Python 内置 venv 虚拟环境工具使用及 uv 升级教程
    • OpenCode Superpowers 插件安装与使用指南
    • PicDoc AI 文生图表工具使用教程与 Napkin 对比
    • C++ 相对运动动画实战:葫芦娃飞向太空
    • 新手如何从零开始学习漏洞挖掘与渗透测试
    • Qwen3-4B-Instruct 多行业落地实践:教育、法律与电商文案生成

    相关免费在线工具

    • 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