第 04 章 | 环境准备清单

更新于 2026/5/9
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

第 4 章：环境准备清单

学习目标

确认你的机器装好了运行 doc2video 项目所需的所有先决条件。

一次性检查脚本

把下面这段贴进终端，结果会列出每个工具的状态：

echo "=== 必装 ==="
node --version 2>/dev/null && echo "✓ Node" || echo "✗ Node (需要 20.19+)"
python3 --version 2>/dev/null && echo "✓ Python" || echo "✗ Python (需要 3.11+)"
git --version 2>/dev/null && echo "✓ git" || echo "✗ git"
which tmux >/dev/null && echo "✓ tmux" || echo "✗ tmux"
which ffmpeg >/dev/null && echo "✓ ffmpeg" || echo "✗ ffmpeg"
ls /Applications/Google\ Chrome.app >/dev/null 2>&1 && echo "✓ Chrome" || echo "✗ Chrome"

echo ""
echo "=== macOS 版本 ==="
sw_vers -productVersion

期望输出：

✓ Node
✓ Python
✓ git
✓ tmux
✓ ffmpeg
✓ Chrome

15.0.0  (macOS 12+ 即可)

缺什么补什么

flowchart TB
    Start["跑检查脚本"] --> Q1{Node ?}
    Q1 -->|缺| InstallNode["brew install node
或 nvm install 22"]
    Q1 -->|有| Q2{Python ?}
    InstallNode --> Q2
    Q2 -->|缺| InstallPy["brew install [email protected]"]
    Q2 -->|有| Q3{tmux + ffmpeg ?}
    InstallPy --> Q3
    Q3 -->|缺| InstallSys["brew install tmux ffmpeg"]
    Q3 -->|有| Q4{Chrome ?}
    InstallSys --> Q4
    Q4 -->|缺| InstallChrome["从 google.com/chrome 装"]
    Q4 -->|有| Done["✓ 环境就绪"]
    InstallChrome --> Done

    style Done fill:#c8e6c9

常见坑

现象 原因 解决
python3 --version 是 3.9 macOS 自带的旧 Python brew install [email protected] 然后用 python3.11
Node 是 v18 旧版本 nvm install 22
Apple Silicon 上 ffmpeg 慢 装到了 x86_64 brew arch -arm64 brew reinstall ffmpeg
tmux 启动报错 macOS Sonoma 14.x bug 升级到最新 brew tmux

不要做的事

✗ 用 sudo pip install ...        全局污染
✗ 用 conda                       与 venv 混乱
✗ 跨用户共享 brew                权限会乱

你现在能做什么

  • 验证你的机器满足所有先决条件
  • 知道任一工具缺失时怎么补

下一章装 Claude Code 本体。