f2 项目（多平台的作品下载与接口数据处理）源码部署记录

摘要

F2 是一个 Python 库，提供多平台的作品下载与接口数据处理。支持 DouYin、TikTok、Twitter、WeiBo 等平台，且方便适配更多平台。

项目地址：https://github.com/Johnserf-Seed/f2

官方文档：https://f2.wiki/install

记录时间：2026-05-02

[f2 项目源码部署记录](#f2 项目源码部署记录)

一、环境信息

二、部署步骤

[1. 打开 VS2022 开发者命令行](#1. 打开 VS2022 开发者命令行)

[2. 准备 Python 环境](#2. 准备 Python 环境)

[3. 安装项目（可编辑模式）](#3. 安装项目（可编辑模式）)

[4. 验证安装](#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.exe

2. 准备 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。
测试下载：尝试运行一条简单命令验证功能，例如：

cmd
复制代码
```
f2 dy -u "作品链接"
```
日志调试 ：如遇问题，可加上 -d DEBUG 参数查看详细日志：

cmd
复制代码
```
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