开发环境、账号与项目准备

第 02 课：开发环境、账号与项目准备

本节为免费内容。

本节学习目标

本节完成后，你将能够：

• 理解“开发环境、账号与项目准备”在完整系统中的作用
• 按步骤完成本节的配置或实现
• 验证结果并识别常见错误

本节预计学习时间

10–15 分钟

前置要求

已完成上一课；能够在 Windows CMD 中运行命令。

本节说明

准备 Python 3.11、Node.js、FFmpeg、AI 服务和项目目录。

核心概念

稳定的媒体生成项目依赖可重复的环境。Python 负责桌面应用和服务编排，Node.js 运行 Remotion，FFmpeg 处理媒体，AI 服务负责转写、分析、视觉理解和语音合成。

分步骤操作

Step 1：确认 Python 3.11

python --version

预期看到：

Python 3.11.x

创建虚拟环境：

python -m venv app\.venv
app\.venv\Scripts\python.exe -m pip install --upgrade pip

Step 2：确认 Node.js 和 npm

node --version
npm --version

Step 3：确认 FFmpeg

ffmpeg -version
ffprobe -version

Step 4：安装项目依赖

根据项目的依赖文件执行：

app\.venv\Scripts\python.exe -m pip install -r requirements.txt
cd remotion
npm install

Step 5：建立安全配置

API key 只能放入本地环境变量或未提交的 .env 文件，例如：

OPENAI_API_KEY=your-placeholder-key

不要把真实 key 写进课程文件、源码或 ZIP。

操作结果说明

Python、Node.js、npm、FFmpeg 和项目依赖均可从命令行正常调用。

常见错误与解决办法

python 指向错误版本

使用 Python 3.11 的完整路径创建虚拟环境。

ffmpeg 不是内部或外部命令

把 FFmpeg 的 bin 目录加入 Windows PATH，然后重新打开 CMD。

最佳实践

每个项目使用独立虚拟环境，并用 pip check 验证依赖一致性。

本节总结

你已经准备好本项目所需的基础运行环境。

实践任务

运行 Python、Node.js、npm 和 FFmpeg 的版本检查，并保存结果。

下一步

下一节将进入第 03 课。