AppFlowy 安装配置实战：从克隆到跑通的全流程

AppFlowy 安装配置实战从克隆到跑通的全流程【免费下载链接】AppFlowyBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowyAppFlowy 是一个开源的 AI 协作工作空间也是最有名的 Notion 开源替代品文档、看板、数据库视图和 AI 聊天都在一个工作区里核心逻辑跑在本地数据默认握在自己手里。它用 Flutter Rust 双栈实现适合想自托管工作区的个人用户也适合想啃一份前端 Flutter、底层 Rust代码库的工程师。项目速写AppFlowy 是什么、用什么写的它解决的核心痛点是想要 Notion 的功能又不想把数据交给别人协作编辑、多视图管理、AI 助手一应俱全但你可以完全掌控存储和部署。对工程师来说这份代码库还是学习 FFI 跨语言协作的好样本。语言/框架承担的角色备注Dart / Flutter跨平台 UI桌面端 移动端你看到的所有界面都是 FlutterRust核心逻辑文档、数据库、协作、AI编译为dart_ffi动态库被 Flutter 通过 FFI 调用cargo-make任务编排把编译、拷贝、打包全部封装成任务入口在frontend/Makefile.tomlSQLitediesel本地持久化迁移脚本在 flowy-sqlite 目录protobuf与后端通信的网络协议云端同步用环境体检AppFlowy 环境搭建前检查清单动手之前先对照这份体检报告逐项确认。缺哪项补哪项别急着开工。☐ ✅ Flutter SDK — stable 通道3.x— 验证flutter --version☐ ✅ Rust 工具链 — stable 版本建议用 rustup 管理 — 验证rustc --version☐ ⚠️ cargo-make — 任务入口缺它后面所有cargo make命令直接失效 — 验证cargo make --version☐ ⚠️ 仅 Windowsvcpkg sqlite3 — Rust 端依赖系统 sqlite缺了一堆链接错误 — 验证vcpkg_cli probe sqlite3☐ ⚠️ 仅 Windowsduckscript — cargo-make 在 Windows 上靠它执行脚本 — 验证duck --version☐ ✅ Linux 用户 — CMake、clang 需就位 — 验证cmake --version☐ ⚠️ 磁盘 — 首次全量编译轻松吃掉 10GB 以上先留足空间带 ⚠️ 的三项是最常见的翻车点✅ 项全部通过就可以直接进落地五站。落地五站AppFlowy 本地运行全流程 约定除特别说明外所有命令都在仓库根目录的frontend/下执行。第 1 站获取代码目标拿到完整代码库后续一切以此为根。git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowy/frontend # 后面所有命令都在这层目录下跑判断标准ls能看到appflowy_flutter、rust-lib两个目录和Makefile.toml。第 2 站装核心依赖目标Flutter 和 Rust 两侧的依赖工具都就位。# 安装任务编排工具每台机器一次即可 cargo install cargo-make --locked # 拉取 Dart 侧依赖 cd appflowy_flutter flutter pub getWindows 额外一步# 先按 vcpkg 官方文档装好 vcpkg 并加入 PATH再装系统 sqlite vcpkg install sqlite3:x64-windows-static-md # 让 Rust 构建能找到它 cargo install vcpkg_cli判断标准flutter pub get结尾出现Got dependencies!且无红色报错卡住多半是网络代理没配好。第 3 站AppFlowy 项目级配置目标把 Rust 核心编译成动态库并交给 Flutter 侧。这站是全流程最耗时的一步首次编译数百个 crate建议先去倒杯咖啡。cd frontend # dev 模式构建 dart-ffi 核心库任务会自动把产物拷进 flutter 包 cargo make appflowy-core-dev # 可选要接自建云端就改 dev.env 里的 APPFLOWY_CLOUD_URL留空即本地模式判断标准结尾出现Finished dev profile全程没有error[行如果长时间卡在同一行一般是依赖下载慢不是代码问题。第 4 站本地启动 目标让窗口真正弹出来。cd appflowy_flutter # 按你的系统三选一 flutter run -d macos # macOS flutter run -d windows # Windows flutter run -d linux # Linux判断标准终端无编译错误窗口出现启动页并进入登录/工作区选择界面如果报dart_ffi加载失败说明第 3 站没跑完回去重跑一遍。第 5 站构建产物目标拿到可分发的 release 包而不是一个调试窗口。cd frontend # 按平台选择任务名注意与运行阶段的别名不同 cargo make appflowy-macos # macOS产出 .app 包 cargo make appflowy-linux # Linux产出 release 归档判断标准build/下对应平台目录出现产物体积几十 MB 起若开头就报env_check失败通常是 cargo-make 版本过旧cargo install cargo-make --locked升级后再试。跑通之后两个确实起来了的信号终端里flutter run停留在Syncing files to device没有崩溃堆栈窗口里能新建一篇文档并保存到本地。进程目录中加载了libdart_ffi动态库说明 Rust 核心在真正工作而不是只有 UI 空壳。接下来值得逛的三个方向改配置编辑 appflowy_flutter/dev.env指定自建 AppFlowy Cloud 地址或留空保持纯本地。Rust 核心入口rust-lib/dart-ffi/ 是 Flutter 与 Rust 之间的 FFI 桥梁读源码从这里开始最合适。UI 插件层appflowy_flutter/lib/plugins/ 下按 document、database、ai_chat 分模块边界清晰方便定点修改。【免费下载链接】AppFlowyBring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.项目地址: https://gitcode.com/GitHub_Trending/ap/AppFlowy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考