📖 前置基础准备

开始之前,准备好你的工具箱

本模块带你完成AI项目开发的所有前置环境配置,包括硬件选型、软件安装、核心库配置等。配置完成后即可进入实战学习。

📋 学习进度
0 / 6 已完成

✅ 环境配置检查清单 (点击标记完成)

🖥️

硬件选型指南

GPU 是深度学习的核心,按需求选择:

使用场景 推荐GPU 显存 大致预算
学习 / 小项目RTX 306012GB~2000元
中型项目 / 竞赛RTX 4070 Ti Super16GB~5000元
大型模型训练RTX 4090 / A600024-48GB1万+
云端按需(省钱)Colab Pro / 阿里云16-80GB按时计费

📌 最低配置(CPU模式)

  • • CPU:Intel i5 / AMD Ryzen 5
  • • 内存:8GB(建议16GB)
  • • 存储:200GB SSD
  • • 适用:小数据集、教学学习

⭐ 推荐配置(GPU加速)

  • • CPU:Intel i7 / AMD Ryzen 7+
  • • GPU:RTX 3060 12GB 以上
  • • 内存:32GB DDR4/DDR5
  • • 存储:1TB NVMe SSD + 2TB HDD
💻
Software Setup

软件环境配置 (交互式)

🐍 Python 安装与版本选择

推荐使用 3.10 或 3.11,AI 库兼容性最佳;3.12+ 部分底层包尚未完全适配。

🎯 版本选择建议(必看)
✅ 推荐:Python 3.10
• 所有主流 AI 库完美支持
• 稳定性高,社区资源丰富
• conda create -n ai python=3.10
👍 次选:Python 3.11
• 比 3.10 快 10~60%
• 绝大多数库已支持
• 追求性能的用户可选择
⚠️ 暂不推荐:3.12+
• 部分底层 C 扩展包未更新
• PyTorch/TensorFlow 兼容一般
• 新手容易踩编译坑
🐍
安装步骤:
  1. 下载 Windows installer (64-bit)(别下成 32-bit)
  2. 双击运行安装程序
  3. 最关键一步:勾选界面底部的 Add Python to PATH
  4. 选择 Install Now(默认安装到 C 盘用户目录)
  5. 安装完成后勾选 Disable path length limit(解除 260 字符路径限制)
⚠️ PATH 未勾选的补救方法
重新运行安装包 → 选择 Modify → 下一步 → 勾选 Add Python to environment variables → Install。
✅ 验证是否安装成功
# 打开终端(Win: cmd/PowerShell,Mac/Linux: Terminal)
python --version # Windows
python3 --version # macOS / Linux
# ✅ 成功示例:输出 → Python 3.10.14 或 Python 3.11.x
# ❌ 如果报错 "不是内部或外部命令",说明 PATH 没配置好,回到上方查看对应平台的补救方法。

📦 Anaconda / Conda 环境管理

Conda 是跨平台的包 & 环境双重管理器,是 AI 开发的标配:一个项目一个独立环境,依赖绝不打架。

🤔 Miniconda vs Anaconda?选哪个?
Miniconda
⭐ 新手推荐
  • ✅ 体积仅 ~80MB,下载安装快
  • ✅ 只装 conda + Python,干净
  • ✅ 需要什么 pip/conda install 再装
  • ✅ 启动快,占用磁盘少
🔗 docs.conda.io/miniconda.html ↗
Anaconda
  • 📦 预装 1500+ 科学计算包
  • 📦 体积大(~3GB),安装慢
  • 📦 带 Anaconda Navigator 图形界面
  • 📦 适合离线/教学实验室/不愿装包的用户
🔗 anaconda.com/download ↗
� 结论:99% 的情况选 Miniconda。Conda 是底层命令工具,Miniconda / Anaconda 都是它的发行版(就像 Chrome 和 Chromium 的关系)。
🚀 国内用户必做:切换清华镜像

官方源服务器在国外,下载速度 几 KB/s 是家常便饭。切换到国内镜像后可达 10MB/s+。

Windows(Anaconda Prompt 执行)
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
conda config --set show_channel_urls yes
macOS / Linux(写入 ~/.condarc)
cat > ~/.condarc << 'EOF'
channels:
  - defaults
show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
custom_channels:
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
EOF
同时给 pip 也换源(一次配置永久生效):
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host mirrors.tuna.tsinghua.edu.cn
🛠️ Conda 常用命令速查表(复制即用)
## ========== 环境管理 ==========
# 创建 AI 开发环境(Python 3.10,环境名 ai_dev)
conda create -n ai_dev python=3.10 -y
# 激活环境(每次开新终端第一步!)
conda activate ai_dev # Win / Mac(Linux new)
source activate ai_dev # Mac / Linux (旧版)
# 退出当前环境
conda deactivate
# 查看所有环境(当前环境前会有 * 号)
conda env list
# 删除环境(慎用,不可恢复)
conda env remove -n old_env -y
## ========== 包管理 ==========
conda list # 列出已安装的包
conda install numpy -y # 安装包(-y 跳过确认)
conda remove numpy -y # 卸载包
conda update --all -y # 批量升级所有包
## ========== 环境分享 ==========
# 把当前环境导出为 environment.yml(发给队友/服务器重建)
conda env export > environment.yml
# 从 yml 文件重建一模一样的环境
conda env create -f environment.yml
⚡
进阶提速:用 Mamba 替代 Conda
Conda 的依赖解算器在复杂环境下非常慢(可能卡几十分钟)。Mamba 是它的 C++ 重写版,速度快 5~10 倍,命令语法完全一样。
conda install -n base -c conda-forge mamba -y # 之后把所有 conda 换成 mamba 即可

🎮 CUDA / GPU 驱动配置

有 NVIDIA 显卡就装 CUDA 加速训练;没有也能用 CPU 跑(速度慢些,学习阶段没问题)。

🔍 第一步:先确认你的显卡类型
🟢 NVIDIA GPU
RTX 20/30/40 系列、A 系列等
支持 CUDA → 速度最佳 ✅
🟡 AMD GPU
RX 6000/7000 系列
需用 ROCm(Linux 支持好)
⚪ 无独立显卡
Apple Silicon / 核显 / 无显卡
CPU 模式,中小模型够用
🟢 方案 A:NVIDIA GPU + CUDA(强烈推荐)
1
安装/更新 NVIDIA 显卡驱动
  • Windows:去 NVIDIA 官网驱动下载 ↗,按型号下载 Studio 版(更稳定)或 Game Ready 版,安装后重启。
  • Ubuntu:sudo ubuntu-drivers autoinstall && sudo reboot
  • ✅ 验证:终端运行 nvidia-smi,能看到 GPU 型号 + Driver Version 即成功。
2
用 Conda 装 PyTorch + CUDA(不需要单独装 CUDA Toolkit!)
💡 关键知识点:PyTorch 官方 conda 包已经把对应版本的 CUDA 运行时打包进去了,不需要手动去 NVIDIA 官网下载几百 MB 的 CUDA Toolkit(除非你要写 CUDA C++ 代码)。
👉 根据 PyTorch 官网 ↗ 的交互式选择器获取最新命令,以下是常用组合:
# Conda 方式(推荐,自动处理依赖)
conda install pytorch torchvision torchaudio pytorch-cuda=12.4 -c pytorch -c nvidia -y
# 或者 pip 方式
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
# cu121 = CUDA 12.1,cu118 = CUDA 11.8,cu124 = CUDA 12.4(越新对新卡支持越好)
3
验证 GPU 是否正常工作
import torch
print("torch版本:", torch.__version__)
print("CUDA可用:", torch.cuda.is_available()) # ✅ 应输出 True
print("GPU型号:", torch.cuda.get_device_name(0) if torch.cuda.is_available() else "无GPU")
print("CUDA版本:", torch.version.cuda) # 如 12.4
AMD 方案 B:AMD GPU(ROCm)

AMD 显卡用 ROCm 替代 CUDA,目前仅 Linux 支持较好,Windows 体验有限。

# Ubuntu 22.04 + RX 7900XTX 等新卡
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.1
🔗 ROCm 官方文档 ↗
⚪ 方案 C:纯 CPU 模式

没有 NVIDIA/AMD 显卡,或用 Apple M 系列芯片(MPS 加速)也能学习。

# 纯 CPU 版本
conda install pytorch torchvision torchaudio cpuonly -c pytorch -y
# Apple Silicon 会自动走 MPS 后端,速度比 CPU 快 2~4 倍

📝 编辑器与 IDE 推荐

工欲善其事,必先利其器。选对工具,开发效率翻倍。以下是 AI 项目开发的 4 种主流选择:

⭐ 推荐首选
📝
VS Code
主力编辑器 · 生态最丰富

轻量强大、插件生态第一、智能提示优秀,社区最大。AI 开发的绝对主流选择。

🔌
AI 开发必装插件 Top 6
打开 VS Code → 扩展商店 → 搜索名称 → 一键安装
#01
🐍
Python
✨ 微软官方 · 亿级下载
语法高亮 · 调试器 · Lint 检查 · 环境切换 · IntelliSense 补全
#02
💡
Pylance
✨ 微软官方 · 极速补全
类型推断 · 参数提示 · 跳转到定义 · 大规模代码库搜索毫秒级响应
#03
📓
Jupyter
✨ 微软官方 · 笔记本直连
单元格直接运行 · 变量查看器 · 可视化图表内联渲染 · 不用开JupyterLab
#04
🔀
GitLens
⭐ 团队协作必备
每行代码显示"谁改的 / 什么时候改的" · Blame 视图 · Commit 对比 · Rebase 可视化
#05
🌈
Indent Rainbow
🎨 可读性救星
不同缩进层级用不同颜色标注 · Python/JSON/YAML 这种靠缩进的语言告别对齐错误
#06
✨
Trae
🤖 AI 原生插件 · 字节出品
多模型聊天 · @文件注入上下文 · 自然语言生成/重构 · 浏览器自动化 · 一键终端
🔗 code.visualstudio.com ↗
🔬 实验首选
📓
JupyterLab
交互式笔记本 · 数据分析与模型实验神器

单元格即跑 + 可视化内联 + Markdown/代码/数学混排,边跑实验边记笔记、边看图边调参,数据探索和模型训练阶段无可替代。

📦 安装命令
pip install jupyterlab
🚀 启动命令
jupyter lab
🌐 访问地址
http://localhost:8888
⌨
常用快捷键 Top 5
命令模式下按 Esc 进入
A
上方插入单元格
B
下方插入单元格
Ctrl + Enter
运行当前单元格
Shift + Enter
运行并跳到下一格
D + D
删除当前单元格(按两次 D)
🔗 jupyter.org ↗
🏢 企业级
🏢
PyCharm Professional
功能最全面的 Python IDE

智能重构、远程开发、数据库工具、科学计算模式一体化,大型工程/团队协作首选。

✅ 智能代码补全
✅ 远程 SSH 开发
✅ 数据库浏览器
✅ Jupyter 内置
✅ 可视化 Debug
✅ Profiler 性能分析
💰 付费 ¥19/月 🎓 学生免费 Community 版免费
🤖 AI 时代
✨
Cursor / Trae
AI 原生编程 · 效率 10x

在 VS Code 基础上深度集成 AI 大模型:自然语言生成代码、智能重构、自动修 bug、文档对话。

🤖 AI 核心能力速览
⚡ Tab 自动补全
💬 Chat 对话问答
🔧 重构 & 解释代码
🐛 自动修复 Bug
📄 @文件 / 文档注入
🧪 自动生成单测
🆓 免费版够用 Pro ¥20/月

🧩 核心 Python 库速查 & 一键安装

AI 项目开发最常用的 6 大类库,按需复制安装命令,建议在已激活的 Conda 环境中执行。

📊 数据科学基础
pip install numpy pandas scipy jupyterlab

NumPy(数值数组)· Pandas(表格数据)· SciPy(科学计算)· JupyterLab(交互式笔记本)

📈 数据可视化
pip install matplotlib seaborn plotly altair

Matplotlib(基础绘图)· Seaborn(统计美化)· Plotly(交互式)· Altair(声明式图)

🤖 传统机器学习
pip install scikit-learn xgboost lightgbm catboost

scikit-learn(分类回归聚类)· XGBoost/LightGBM/CatBoost(Kaggle 三大杀器 GBDT)

🔥 深度学习框架
# ⚠️ PyTorch 请去 pytorch.org 获取对应 CUDA 版本命令
# pip install torch torchvision torchaudio --index-url .../cu124

# TensorFlow 2.x
pip install tensorflow

PyTorch(学术界主流)· TensorFlow/Keras(工业界部署)· 二选一即可,推荐新手用 PyTorch

🖼️ CV / NLP / HuggingFace
pip install opencv-python pillow transformers datasets accelerate sentencepiece

OpenCV/Pillow(图像处理)· Transformers/Datasets(HuggingFace 大模型生态)

🛠️ 开发 & 工程工具
pip install tqdm requests beautifulsoup4 pyyaml python-dotenv loguru

tqdm(进度条)· requests/bs4(HTTP+爬虫)· pyyaml/dotenv(配置文件)· loguru(优雅日志)

⚡ 一键安装(新手快速起步,不包含 PyTorch/TensorFlow)
pip install numpy pandas scipy matplotlib seaborn plotly \
    scikit-learn xgboost lightgbm \
    opencv-python pillow transformers datasets \
    tqdm requests beautifulsoup4 pyyaml jupyterlab

� 说明:PyTorch/TensorFlow 需要根据你的 CUDA 版本从官网单独安装(见上一步 🎮 CUDA/GPU 驱动)。以上命令在已激活的 conda 环境中执行即可。

⚡

快速启动方案选择器

告诉我你的情况,我帮你选最优方案:
← 返回首页 下一章:需求定义 →