环境搭建:从零配置AI开发环境
环境搭建:从零配置AI开发环境
本文是《AI学习系列》第3篇,将手把手教你从零开始搭建一个完整的Python AI开发环境。无论你是Windows、Mac还是Linux用户,都能跟着这篇教程完成环境配置。
一、为什么需要专门的AI开发环境?
在开始写第一行代码之前,我们需要先理解:为什么不能直接用系统自带的Python?
- 版本隔离:不同项目可能需要不同版本的Python或依赖库
- 依赖管理:AI项目通常涉及大量第三方库(numpy、pandas、torch等),容易产生冲突
- 可复现性:规范的环境配置能让你的代码在别人电脑上也能跑起来
核心原则:每个AI项目都应该有自己独立的环境!
二、安装Python环境
1. 下载并安装Python
推荐版本:Python 3.9 ~ 3.11(稳定性与兼容性最佳)
Windows用户:
# 访问官网下载
https://www.python.org/downloads/
# 安装时务必勾选:
☑️ Add Python to PATH(将Python添加到系统环境变量)
Mac用户:
# 推荐使用Homebrew安装
brew install python@3.10
# 或直接官网下载安装包
Linux用户(Ubuntu/Debian):
sudo apt update
sudo apt install python3.10 python3-pip python3-venv
2. 验证安装成功
打开终端(命令提示符),输入:
python --version
# 应输出:Python 3.x.x
pip --version
# 应输出:pip xx.x.x from ...
如果能看到版本号,恭喜你,Python已经安装成功了!
三、虚拟环境管理(必学!)
虚拟环境是Python开发的最佳实践,它能让你在不同项目中使用不同版本的库而互不干扰。
方案A:使用 venv(Python内置,推荐新手)
# 创建虚拟环境(在项目目录下执行)
python -m venv ai_env
# 激活虚拟环境
# Windows:
ai_env\Scripts\activate
# Mac/Linux:
source ai_env/bin/activate
激活后,你会看到终端前面出现了 (ai_env) 标识,说明已经进入虚拟环境。
方案B:使用 Conda(功能更强大)
# 下载安装 Miniconda(轻量版)
https://docs.conda.io/en/latest/miniconda.html
# 创建新环境
conda create -n ai_env python=3.10
# 激活环境
conda activate ai_env
退出虚拟环境:
deactivate # venv方式
conda deactivate # conda方式
四、安装Jupyter Notebook
Jupyter是AI/数据科学领域最流行的交互式编程工具,可以边写代码边看结果,非常适合学习和实验。
pip install jupyter
# 启动Jupyter
jupyter notebook
执行后会自动打开浏览器,显示文件管理界面。点击 New → Python 3 即可创建新的Notebook。
Jupyter常用快捷键(效率翻倍!)
| 操作 | 快捷键 |
|---|---|
| 运行当前单元格 | Shift + Enter |
| 新建单元格 | B(下方)/ A(上方) |
| 切换单元格类型 | M(Markdown)/ Y(代码) |
| 显示帮助文档 | Shift + Tab(按多次展开详情) |
💡 小技巧:如果想获得更好的体验,可以试试 Jupyter Lab(Jupyter的升级版)
pip install jupyterlab jupyter lab
五、安装AI常用库
以下是AI学习必备的核心库,一次性安装:
# 核心科学计算库
pip install numpy pandas matplotlib scipy
# 机器学习库
pip install scikit-learn
# 深度学习框架(二选一即可,推荐PyTorch)
pip install torch torchvision torchaudio
# 或者 TensorFlow
# pip install tensorflow
# 数据处理与可视化
pip install seaborn plotly pillow opencv-python
# NLP自然语言处理
pip install nltk jieba transformers
# 模型部署相关
pip install flask fastapi uvicorn
验证安装是否成功
创建一个测试文件或在Jupyter中运行:
import numpy as np
import pandas as pd
import matplotlib.pyplot as plt
import sklearn
import torch
print("NumPy 版本:", np.__version__)
print("Pandas 版本:", pd.__version__)
print("Scikit-learn 版本:", sklearn.__version__)
print("PyTorch 版本:", torch.__version__)
print("\n✅ 所有库安装成功!")
如果所有版本号都正常输出,说明环境配置完成!
六、IDE推荐(提升开发效率)
虽然Jupyter适合实验,但正式项目开发还是需要专业的IDE:
1. VS Code(强烈推荐⭐⭐⭐⭐⭐)
- 免费开源,插件生态丰富
- Python支持极佳(Microsoft官方维护)
- 安装插件:
Python、Jupyter、Pylance - 下载地址:https://code.visualstudio.com/
2. PyCharm
- JetBrains出品,功能强大
- 社区版免费,专业版收费(学生可免费申请)
- 内置很多便捷功能
3. Google Colab(云端选择)
- 无需本地配置,浏览器即可使用
- 免费GPU资源,适合深度学习入门
- 地址:https://colab.research.google.com/
七、常见问题排查(FAQ)
Q1: pip安装速度太慢怎么办?
使用国内镜像源:
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
或者永久配置:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Q2: 安装包时报错 “Permission denied”
# 不要用 sudo pip install!应该:
pip install --user 包名
# 或确保在虚拟环境中操作
Q3: ImportError: No module named ‘xxx’
检查三点:
- 是否激活了正确的虚拟环境?
- 包是否真的安装了?用
pip list | grep xxx查看 - 包名和导入名是否一致?(如
scikit-learn导入时是sklearn)
Q4: PyTorch安装失败
访问官网获取适配你系统的安装命令:
https://pytorch.org/get-started/locally/
根据你的CUDA版本选择对应命令。
八、总结与环境清单
完成以上步骤后,你应该拥有:
✅ Python 3.9~3.11
✅ 虚拟环境工具(venv 或 conda)
✅ Jupyter Notebook / Lab
✅ 核心计算库:numpy, pandas, matplotlib
✅ 机器学习库:scikit-learn
✅ 深度学习框架:PyTorch 或 TensorFlow
✅ 一个顺手的IDE(VS Code推荐)
下一步行动建议:
- 用Jupyter运行一段简单的numpy代码,确认环境正常
- 尝试创建一个新的虚拟环境,练习环境切换
- 准备好迎接下一篇:《第一个AI项目:手写数字识别》
参考资源
📌 系列导航:
👈 02 AI全景图:一张图看懂AI生态 |
04 第一个AI项目:手写数字识别 👉关注我,持续更新AI学习干货!如果这篇文章对你有帮助,欢迎点赞收藏 ❤️
更多推荐


所有评论(0)