Python3 环境搭建指南

Python 3 环境搭建指南

🎯 学习目标

掌握 Python 3 的安装与环境配置方法，能够在不同操作系统（Windows、macOS、Linux）上正确安装 Python 解释器，并配置开发工具和虚拟环境，为后续学习和项目开发做好准备。

🔑 核心重点

分类 内容
安装平台 Windows、macOS、Linux
官方下载地址 https://www.python.org/downloads/
安装注意事项 勾选 Add to PATH
验证安装 使用 python --version 或 python3 --version
开发工具 IDLE、VS Code、PyCharm、Jupyter Notebook 等
虚拟环境 推荐使用 venv 或 conda 创建隔离环境
包管理工具 pip 是默认包管理器，用于安装第三方库
多版本共存 可通过 py（Windows）或别名（Linux/macOS）切换版本

📚 详细讲解

1️⃣ 下载并安装 Python 3

✅ 官网地址：

👉 https://www.python.org/downloads/

根据你的操作系统选择合适的安装包。

2️⃣ 在不同系统中安装 Python 3

🖥️ Windows 安装步骤：

  1. 访问官网，点击“Download Windows x86/x64 executable installer”。
  2. 双击下载的 .exe 文件运行安装程序。
  3. 务必勾选 “Add Python 3.x to PATH”。
  4. 点击 “Install Now” 进行默认安装。
  5. 安装完成后，在命令提示符中输入：
python --version
pip --version

确认是否安装成功。

⚠️ 若有多个版本，可使用 py -3 启动 Python 3。

🍎 macOS 安装步骤：

macOS 自带 Python 2，但建议安装最新 Python 3：

  1. 下载 macOS 安装包（如 python-3.x.x-macosx.pkg）。
  2. 双击安装包进行图形化安装。
  3. 安装完成后在终端执行：
python3 --version
pip3 --version

✅ 推荐使用 Homebrew 安装（更方便管理）：

brew install python

🐧 Linux 安装步骤：

大多数 Linux 发行版自带 Python 3，若需升级或安装新版本：

Ubuntu / Debian：
sudo apt update
sudo apt install python3

验证安装：

python3 --version
CentOS / RHEL：
sudo yum install python3

3️⃣ 配置开发工具（IDE）

✅ 推荐 IDE 工具：

工具 特点
IDLE Python 自带编辑器，适合初学者
VS Code 微软出品，插件丰富，轻量高效，支持调试、Git、自动补全等
PyCharm JetBrains 出品，专业级 Python IDE，社区版免费
Jupyter Notebook 交互式编程环境，适合数据分析、教学演示
Thonny 专为新手设计的简单易用 IDE

4️⃣ 使用虚拟环境（推荐）

为了避免不同项目依赖冲突，推荐使用虚拟环境。

✅ 使用内置模块 venv 创建虚拟环境：

python -m venv myenv      # 创建名为 myenv 的虚拟环境
source myenv/bin/activate  # Linux/macOS 激活
myenv\Scripts\activate     # Windows 激活

激活后，所有 pip install 安装的库都只属于该环境。

退出虚拟环境：

deactivate

5️⃣ 使用 pip 管理包

pip 是 Python 的官方包管理器，用于安装和管理第三方库。

✅ 常用命令：

命令 描述
pip install requests 安装 requests 库
pip uninstall requests 卸载 requests 库
pip list 查看已安装库列表
pip freeze > requirements.txt 导出当前环境依赖
pip install -r requirements.txt 安装依赖文件中的库

6️⃣ 配置环境变量（PATH）

确保 Python 和 pip 能在命令行中全局调用：

🖥️ Windows 设置 PATH：

  1. 打开“此电脑”→“属性”→“高级系统设置”→“环境变量”。
  2. 在“系统变量”中找到 Path，点击“编辑”。
  3. 添加 Python 安装目录（如 C:\Users\用户名\AppData\Local\Programs\Python\Python310）和 Scripts 目录。

🍎 macOS/Linux 设置 PATH（可选）：

如果你发现 python 命令无法识别，可以创建别名或修改 .bashrc / .zshrc 文件添加路径：

alias python='python3'
alias pip='pip3'

然后执行：

source ~/.bashrc   # 或 source ~/.zshrc

7️⃣ 多版本 Python 共存（进阶）

有时需要同时使用 Python 2 和 Python 3，可以通过以下方式切换：

🖥️ Windows：

使用 py 命令加参数切换版本：

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

🍎 macOS/Linux：

通常 python 默认指向 Python 2，python3 指向 Python 3。你可以使用 update-alternatives 或创建别名来灵活控制。

⚠️ 注意事项

  • 安装时务必勾选“Add to PATH”，否则需手动配置环境变量。
  • 不同系统下 Python 命令可能略有差异（如 python vs python3）。
  • 使用虚拟环境可以有效避免项目依赖冲突。
  • 安装第三方库前建议先激活对应虚拟环境。
  • 不要随意卸载系统自带的 Python，以免影响系统稳定性。

🧪 实际案例分析

📌 场景：搭建一个 Flask Web 项目环境

步骤如下：

  1. 创建项目目录：
mkdir flask_project
cd flask_project
  1. 创建虚拟环境：
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
  1. 安装 Flask：
pip install flask
  1. 编写一个简单的 Flask 应用（app.py）：
from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, Flask!'

if __name__ == '__main__':
    app.run(debug=True)
  1. 运行应用：
python app.py

  1. 浏览器访问 http://127.0.0.1:5000/，看到输出即可。

  2. 导出依赖：

pip freeze > requirements.txt

🧩 拓展练习（动手实践）

  1. 安装 Python 3，并在命令行中验证是否安装成功。
  2. 使用 pip 安装一个常用库（如 requests 或 numpy），并查看是否安装成功。
  3. 创建一个虚拟环境，并尝试在其中安装和卸载库。
  4. 编写一个简单的 Python 程序（例如输出 “Hello, World!”），并在你选择的 IDE 中运行。
  5. 尝试将当前虚拟环境依赖导出为 requirements.txt 文件。

📚 推荐阅读

🧭 下一步建议

  • 下一章学习内容：《Python 基础语法》
  • 推荐安装 PyCharm 并熟悉其基本功能
  • 动手实践编写第一个 Python 程序（Hello World）
  • 学习如何使用 Git 管理代码版本
  • 加入 Python 社区（如 Python 中文社区、Stack Overflow、Reddit 的 r/learnpython）

如果你希望我为你提供：

  • Python 安装图文教程（含截图）
  • 不同操作系统下配置 Python 环境变量的详细说明
  • VS Code + Python 插件配置指南
  • 使用 Conda 管理 Python 环境的方法
  • 制作自己的第一个 Python 项目模板

欢迎随时告诉我 😊

posted @ 2025-05-27 23:40  红尘过客2022  阅读(413)  评论(0)    收藏  举报