f2 项目（多平台的作品下载与接口数据处理）源码部署记录
f2 项目（多平台的作品下载与接口数据处理）源码部署记录
摘要
F2是一个 Python 库，提供多平台的作品下载与接口数据处理。支持DouYin、TikTok、项目地址：https://github.com/Johnserf-Seed/f2
官方文档：https://f2.wiki/install
记录时间：2026-05-02
目录
f2 项目源码部署记录
一、环境信息
二、部署步骤
1. 打开 VS2022 开发者命令行
2. 准备 Python 环境
3. 安装项目（可编辑模式）
4. 验证安装
三、部署总结
四、后续建议
一、环境信息
| 项目 | 版本/说明 |
|---|---|
| 操作系统 | Windows（x64） |
| Python | 3.11（通过 Conda 环境py311） |
| C++ 编译器 | MSVC 14.42（Visual Studio 2022 Professional） |
| 项目路径 | K:\PythonProjects5\f2 |
| 虚拟环境 | 项目目录下.venv（使用--copies参数创建） |
二、部署步骤
Clink 调校指南：让 Windows CMD 拥有现代终端的便捷体验
拒绝环境嵌套与“假激活”！PyCharm 终端终极调教：pwsh7 + VS2022编译链 + Clink 完美融合
在 PyCharm 中配置 x64 Native Tools Command Prompt for VS 2022 作为默认终端
1. 打开 VS2022 开发者命令行
使用Visual Studio 2022 Developer Command Prompt，确保cl.exe等编译工具可用：
cmd
（或许用不到 VS 2022 环境，但是 凡涉及编译都建议先进入该环境避免工具链调用的问题）
[vcvarsall.bat] Environment initialized for: 'x64'验证编译器路径：
cmd
where cl # D:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Tools\MSVC\14.42.34433\bin\Hostx64\x64\cl.exe2. 准备 Python 环境
【EPGF 白皮书】路径治理驱动的多版本 Python 架构—— Windows 环境治理与 AI 教学开发体系
一次搭好、终身不乱Windows Python 环境治理（EPGF）系列总览 / 阅读路线图 [目录]
这里实践的是 Windows 系统的 EPGF 架构。
先用一条命令快捷切换到python3.11，再基于它创建项目独立的虚拟环境：
cmd
conda activate py311 python -m venv --copies .venv .venv\Scripts\Activate conda deactivate验证虚拟环境生效：
cmd
where python # K:\PythonProjects5\f2\.venv\Scripts\python.exe （优先）3. 安装项目（可编辑模式）
在项目根目录执行源码安装：
cmd
pip install -e .安装过程顺利，所有依赖均从 PyPI 下载并安装成功，包括：
aiofiles,aiosqlite,httpx,websockets等异步依赖black,pytest等开发依赖pyexecjs（需要从源码构建 wheel）pycryptodomex,cryptography等加密相关库
最终输出：
Text
Successfully installed ... f2-0.0.1.7 ...4. 验证安装
执行帮助命令查看是否安装成功：
cmd
f2 -h输出结果正常，显示了：
版本号：f2 0.0.1.7
项目描述：基于异步的全平台下载工具
支持的应用列表（douyin、twitter、tiktok、bark 等）
使用示例和文档链接
注意：
f2 apps -h会报错没有找到 apps 应用，这是正常行为。正确用法是f2 dy -h（查看抖音模块帮助）或f2 tk -h（查看 TikTok 模块帮助）。
三、部署总结
| 检查项 | 状态 |
|---|---|
| 虚拟环境创建 | ✅ 成功 |
| 依赖安装 | ✅ 全部成功 |
| 源码构建（f2 / pyexecjs） | ✅ Wheel 构建成功 |
| CLI 入口可用 | ✅f2 -h正常输出 |
| 版本号确认 | ✅ 0.0.1.7 |
四、后续建议
配置应用：根据你要下载的平台（如抖音、Twitter），参考 f2.wiki 配置对应的 Cookie 或 Token。
测试下载：尝试运行一条简单命令验证功能，例如：
cmdf2 dy -u "作品链接"日志调试：如遇问题，可加上
cmd-d DEBUG参数查看详细日志：f2 -d DEBUG dy -u "作品链接"
结论：本次从源码部署 f2 项目顺利完成，环境配置正确，CLI 工具可正常使用。
其他安装方式：
pip install f2 # 安装最新版本 pip install f2==x.x.x.x # 安装指定版本 pip install -U f2 # 更新到最新版本 pip uninstall f2 # 卸载https://f2.wiki/install