Python 环境搭建全面指南

Python 环境搭建全面指南

• 🗺️ 环境搭建路线图
• 1️⃣ Windows 系统搭建指南
• • 第一步：下载安装包
  • 第二步：安装（❗关键步骤）
  • 第三步：验证安装
• 2️⃣ macOS 系统搭建指南
• • 方法 A：使用官方安装包（推荐新手）
  • 方法 B：使用 Homebrew（推荐开发者）
• 3️⃣ Linux 系统搭建指南 (Ubuntu/Debian/CentOS)
• • Ubuntu/Debian 系列
  • CentOS/RHEL 系列
• 4️⃣ 核心工具配置（所有系统通用）
• • 📦 1. 配置 pip 镜像源（加速下载）
  • 🛡️ 2. 虚拟环境 (Virtual Environment)
• 5️⃣ 选择代码编辑器 (IDE)
• • 🥇 VS Code (Visual Studio Code)
  • 🥈 PyCharm Community (社区版)
• ❓ 常见问题排查 (FAQ)
• 🎉 下一步
• 祝 Python 学习之旅顺利！🚀

这是一份 2026 年最新版 Python 环境搭建全面指南。无论你是 Windows、macOS 还是 Linux 用户，按照以下步骤操作，即可在 10 分钟内完成专业开发环境的配置。

🗺️ 环境搭建路线图

1️⃣ Windows 系统搭建指南

第一步：下载安装包

第二步：安装（❗关键步骤）

双击运行下载的 .exe 文件，务必注意以下两点：

第三步：验证安装

2️⃣ macOS 系统搭建指南

macOS 通常预装了旧版 Python (2.7 或 3.9)，强烈建议安装最新版以避免系统冲突。

方法 A：使用官方安装包（推荐新手）

方法 B：使用 Homebrew（推荐开发者）

如果你已经安装了 Homebrew，这是最方便的管理方式：

# 安装 Python
brew install python

# 验证
python3 –version

3️⃣ Linux 系统搭建指南 (Ubuntu/Debian/CentOS)

Linux 通常预装 Python，但版本可能较老。

Ubuntu/Debian 系列

# 更新软件源
sudo apt update

# 安装 Python 3 和 pip
sudo apt install python3 python3-pip python3-venv -y

# 验证
python3 –version

CentOS/RHEL 系列

# 安装 EPEL 源
sudo yum install epel-release -y

# 安装 Python 3
sudo yum install python3 python3-pip -y

# 验证
python3 –version

4️⃣ 核心工具配置（所有系统通用）

安装好解释器只是第一步，以下是专业开发的标配。

📦 1. 配置 pip 镜像源（加速下载）

国内用户直接连官方源下载库会很慢，建议配置国内镜像（如阿里云、清华源）。

临时使用（单次有效）：

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

永久配置（推荐）：

• Windows: 在 %APPDATA%\\pip\\ 目录下创建 pip.ini 文件，写入：[global]
  index-url = https://pypi.tuna.tsinghua.edu.cn/simple
• macOS/Linux: 在 ~/.config/pip/ 目录下创建 pip.conf 文件，写入同上内容。

🛡️ 2. 虚拟环境 (Virtual Environment)

为什么需要它？ 不同项目可能需要不同版本的库（例如项目 A 用 Django 3，项目 B 用 Django 5）。虚拟环境可以为每个项目创建独立的 Python 空间，避免冲突。

使用方法：

# 1. 创建虚拟环境 (在项目文件夹下)
python -m venv venv
# Mac/Linux 可能是: python3 -m venv venv

# 2. 激活环境
# Windows:
venv\\Scripts\\activate
# macOS/Linux:
source venv/bin/activate

# 激活后，命令行前会出现 (venv) 标志
# 此时安装的库只会存在于这个项目中

# 3. 退出环境
deactivate

5️⃣ 选择代码编辑器 (IDE)

工欲善其事，必先利其器。推荐以下两款：

🥇 VS Code (Visual Studio Code)

• 特点：轻量、免费、插件生态极强。
• 适用：所有阶段，特别是前端+后端全栈开发。
• 必装插件：
  • Python (Microsoft 出品)
  • Pylance (智能提示)
  • Black Formatter (代码格式化)

🥈 PyCharm Community (社区版)

• 特点：功能强大，专为 Python 设计，开箱即用。
• 适用：大型项目开发、数据分析。
• 缺点：占用内存较大，启动稍慢。

❓ 常见问题排查 (FAQ)

🎉 下一步

环境搭建完成后，你可以：

祝 Python 学习之旅顺利！🚀