Python环境搭建：从零开始配置开发环境

原创已于 2025-06-06 19:04:40 修改 · 2.4k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#python #开发语言 #经验分享

于 2025-06-06 15:01:41 首次发布

Python 专栏收录该内容

1 篇文章

订阅专栏

一、为什么你需要学会搭建Python环境？

1. Python是什么？它能做什么？

想象Python就像一把“万能工具刀”——无论是想做个网站、分析数据、写个小游戏，还是研究人工智能，它都能帮你搞定。比如：

豆瓣、Instagram 的后台用了Python
科学家用Python分析实验数据
连ChatGPT的开发者也会用到Python库

2. 为什么环境配置这么重要？

举个生活例子

就像做菜前要先准备好锅和调料，写Python代码前也需要准备好“工作台”。环境没配好会遇到：

代码在自己电脑能运行，发给别人就报错
装了新工具反而把旧项目搞崩溃了
一堆看不懂的英文错误提示（比如ModuleNotFoundError）

3. 别担心！这篇文章会带你轻松过关

写给谁看？
- 完全没接触过编程的小白
- 想从其他语言（比如Java/JavaScript）转Python的开发者
你能学到什么？
- 10分钟完成Python安装（附截图）
- 学会“隔离工作区”（虚拟环境）避免混乱
- 解决90%新手会踩的坑

4. 先看成果：成功的样子

安装完成后，你会在电脑上看到这样的画面：

# 在命令行输入：
python --version
# 显示 → Python 3.11.4  （版本号可能不同）

# 运行你的第一个程序：
print("Hello, World!")  # 屏幕上会打印出这句话！

（小互动提问）
现在打开你的电脑，试着在搜索栏输入cmd（Windows）或终端（Mac），看看能不能找到黑乎乎的“命令行窗口”？
➔ 如果能，你已经完成第一步了！

二、准备工作：选对工具，事半功倍

1. 选择Python版本：Python 2 还是 Python 3？

Python 2 已经退休了！（2020年官方停止维护）
- 现在几乎所有新项目都用 Python 3，所以别纠结，直接装 Python 3！
Python 3 的小版本怎么选？（比如 3.8、3.9、3.10、3.11）
- 推荐选最新的稳定版（比如 Python 3.11），因为：
  - 性能更好，运行更快
  - 有更多新功能
- 特殊情况：如果你的教程/项目明确要求某个版本（比如 3.8），那就装对应的版本。

（小贴士）

不用担心版本问题，Python 允许你电脑上同时装多个版本，后面会教你管理！

2. 检查你的电脑操作系统

Python 在不同系统（Windows / Mac / Linux）上的安装方式略有不同，所以先确认你的电脑是哪种：

Windows：按 Win + R，输入 winver，可以看到系统版本（比如 Windows 10 / 11）。
Mac：点击左上角 🍎 > 关于本机，看是 Intel 芯片还是 Apple Silicon（M1/M2）。
Linux：打开终端，输入 lsb_release -a 或 cat /etc/os-release。

（常见问题）

Q：我是 32 位还是 64 位系统？
A：现在大多数电脑都是 64 位，除非是很老的机器。如果不确定，可以搜索“如何查看电脑位数”。

3. 下载 Python 安装包

官方下载地址：https://www.python.org/downloads/
- 进去后点击黄色的 Download Python 3.x.x（会自动推荐适合你系统的版本）。

（重要提醒）
✅ Windows 用户：安装时一定要勾选 Add Python to PATH（否则后面会报错“python 不是命令”）！
✅ Mac/Linux 用户：如果系统自带 Python 2，不要删它！我们只是额外安装 Python 3，不影响旧版本。

4. 安装前的小检查

为了避免安装失败，先确认：

硬盘空间：Python 安装包大约 50MB，装完后占 200MB 左右，确保 C 盘（或系统盘）有足够空间。
管理员权限：Windows 用户可能需要右键安装包，选择 “以管理员身份运行”。
关闭杀毒软件（偶尔会误拦截安装程序）。

（总结）准备工作清单

选 Python 3（推荐最新稳定版，如 3.11）。
确认电脑系统（Windows / Mac / Linux）。
下载安装包（官网或镜像站）。
Windows 用户记得勾选 Add Python to PATH。

三、Python安装指南：手把手带你完成

（安装前最后确认）
在点击安装按钮前，请再次确认：

已下载对应系统的安装包（Windows是.exe，Mac是.pkg，Linux是.tar.gz）
关闭了所有杀毒软件（特别是360/电脑管家）
电脑已连接电源（笔记本防止中途没电）

1. Windows系统安装

步骤1：双击安装包

务必勾选：
✅ Add Python 3.x to PATH（这是救命选项！）
✅ Install launcher for all users（推荐）

步骤2：选择安装方式

推荐点击 Install Now（默认安装到C盘）
高级用户可选 Customize installation（可以改安装路径）

步骤3：等待安装

会出现进度条（约1-3分钟）
如果卡住，可以尝试：
- 断开VPN
- 重启路由器

步骤4：验证安装

按 Win + R 输入 cmd 回车
在黑色窗口输入：
```
python --version
```
➔ 应该显示 Python 3.x.x
再输入：
```
pip --version
```
➔ 应该显示 pip 23.x.x

（常见问题解决）
❌ 如果提示"python不是内部命令"：

说明没勾选PATH！需要：
1. 卸载重装
2. 或手动添加PATH（需要教程可留言）

2. Mac系统安装（M1/M2芯片特别注意）

步骤1：双击.pkg文件

会看到欢迎界面
一直点击"继续"直到安装完成

步骤2：验证安装

打开终端（在启动台搜"终端"）
输入：
```
python3 --version
```
➔ 注意是 python3 不是 python！

M1/M2芯片特别说明

如果安装失败，试试：
```
brew install python
```
安装后输入 which python3 应该显示：
/opt/homebrew/bin/python3

3. Linux系统安装（Ubuntu为例）

方法1：最简单方式

sudo apt update
sudo apt install python3

方法2：安装最新版

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.11

验证安装

python3 --version

4. 安装后必做的3件事

升级pip（Python的软件管家）：
```
python -m pip install --upgrade pip
```

测试运行代码：

python -c "print('恭喜！你的Python能用了！')"

设置国内镜像（下载提速10倍）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装成功了吗？来做个自检！

✅ 能正确显示Python版本
✅ 能运行print("Hello World")
✅ pip能安装包（试试pip install numpy）

如果都通过，恭喜你！🎉 可以进入下一章学习虚拟环境了！

超详细的Python虚拟环境配置指南（小白友好版）

四、虚拟环境配置：给你的每个项目一个"独立房间"

（先讲个故事帮你理解）

想象你是个画家：

画水彩时用一套颜料
画油画时用另一套颜料

如果混用会怎样？颜色全糊了！Python项目也一样，不同项目需要不同"颜料"（依赖包），虚拟环境就是帮你把颜料分开的"独立画室"。

1. 为什么要用虚拟环境？

避免"包污染"

项目A需要Django 3.2
项目B需要Django 4.1
不用虚拟环境？两个项目会打架！

保持系统干净

不用时直接删除整个环境
不会在系统留下几百个用不到的包

团队协作必备

可以精确记录项目需要的所有依赖
别人能一键复现你的环境

2. 三种创建虚拟环境的方法

方法1：用Python自带的venv（推荐新手）

步骤1：创建环境

# Windows系统：
python -m venv myenv

# Mac/Linux系统：
python3 -m venv myenv

➔ 这会创建一个叫myenv的文件夹（名字可以自己改）

步骤2：激活环境

# Windows：
myenv\Scripts\activate  # 看到(myenv)前缀就成功了！

# Mac/Linux：
source myenv/bin/activate

步骤3：验证
在命令前面应该会出现(myenv)标记：

(myenv) python -c "import sys; print(sys.prefix)"
# 应该显示虚拟环境的路径（不是系统Python路径）

方法2：用virtualenv（更灵活）

先安装：

pip install virtualenv

然后：

virtualenv myenv  # 创建
source myenv/bin/activate  # 激活（Mac/Linux）

方法3：用pipenv（更智能）

pip install pipenv
cd 你的项目文件夹
pipenv install  # 自动创建环境
pipenv shell   # 进入环境

3. 虚拟环境日常使用指南

安装包

(myenv) pip install django  # 只会装到当前环境

查看已安装包
```
(myenv) pip list
```
导出依赖清单
```
(myenv) pip freeze > requirements.txt
```
退出环境
```
deactivate  # 所有系统通用！
```
删除环境
- 直接删除对应的文件夹即可
- 或者用rm -rf myenv（Linux/Mac）

4. 常见问题急救箱

❓ 问：激活环境后命令前面没有(myenv)？

Windows检查：是否用管理员权限运行了终端
Mac/Linux检查：是否用了source命令

❓ 问：提示"找不到activate命令"？

可能是路径错了，试试：

# Windows：
.\myenv\Scripts\activate
# Mac/Linux：
source ./myenv/bin/activate

5. 虚拟环境最佳实践

每个项目单独环境（哪怕项目很小）

环境文件夹放在项目目录内（方便管理）

my_project/
├── .venv/  # 虚拟环境
├── app.py
└── requirements.txt

把requirements.txt加入版本控制
定期清理不用环境（pipenv --rm）

五、总结

🚀 核心收获回顾

环境搭建三步曲
- ✅ 安装Python：选对版本（3.x）、勾选PATH、验证安装
- ✅ 配置虚拟环境：创建独立空间，避免项目冲突
- ✅ 包管理：极速安装依赖，requirements.txt规范共享

✨ 最后鼓励

“配置环境像搭积木，第一次可能歪歪扭扭，但第十次就会又快又稳。现在你已获得Python世界的通行证，接下来就是用代码建造属于你的奇迹了！”