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 安装步骤:

访问官网,点击“Download Windows x86/x64 executable installer”。

双击下载的 .exe 文件运行安装程序。

务必勾选 “Add Python 3.x to PATH”。

点击 “Install Now” 进行默认安装。

安装完成后,在命令提示符中输入:

python --version

pip --version

确认是否安装成功。

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

🍎 macOS 安装步骤:

macOS 自带 Python 2,但建议安装最新 Python 3:

下载 macOS 安装包(如 python-3.x.x-macosx.pkg)。

双击安装包进行图形化安装。

安装完成后在终端执行:

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:

打开“此电脑”→“属性”→“高级系统设置”→“环境变量”。

在“系统变量”中找到 Path,点击“编辑”。

添加 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 项目环境

步骤如下:

创建项目目录:

mkdir flask_project

cd flask_project

创建虚拟环境:

python -m venv venv

source venv/bin/activate # Linux/macOS

venv\Scripts\activate # Windows

安装 Flask:

pip install flask

编写一个简单的 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)

运行应用:

python app.py

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

导出依赖:

pip freeze > requirements.txt

📚 推荐阅读

Python 官方文档

Python 教程 - 菜鸟教程

Python 编程从入门到实践

Flask 官方文档

VS Code + Python 插件官方文档