完整指南：如何在本地免费跑通 AppFlowy 开源 AI 协作工作空间（新手教程）
【免费下载链接】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
AppFlowy 是一款开源的 AI 协作工作空间，把文档、数据库、看板和 AI 对话整合在一处，适合想管理项目与团队维基、又不想把数据交给云端服务的个人和小团队。
它是谁，为何值得装
你可以把 AppFlowy 理解为「Notion 的开源替代品」：同样有文档、表格和看板，但所有数据默认存在你自己的机器上，而不是别人家的服务器。它用一套代码同时支持桌面和移动端，并且完全免费、可自托管。对在意数据主权、又想要协作体验的人来说，这是目前少数「装在自己电脑上也能用」的选择。
技术底座
整个项目分三层，各司其职：
| 层次 | 技术 | 负责什么 |
|---|---|---|
| 界面 | Flutter + Dart | 跨平台 UI，一套代码出桌面和移动应用 |
| 底层逻辑 | Rust | 文档解析、数据库、协作同步等性能敏感的核心业务 |
| 构建 | Cargo、CMake、Flutter 工具链 | 编译 Rust 核心并打包成各平台可执行文件 |
其中 Rust 核心位于 frontend/rust-lib/，界面代码在 frontend/appflowy_flutter/，读源码时按这两个目录入口找就行。
开工前自检
动手前花一分钟逐项核对，能避开大部分报错：
- 系统是 macOS、Windows 或 Linux（Linux 需装 GTK 3 开发环境）
- 已安装 Flutter SDK（stable 渠道），且
flutter doctor无红色告警 - 已安装 Rust 工具链（通过 rustup 安装，
cargo --version有输出） - 已安装 CMake 与对应系统的编译器（macOS 用 Xcode Command Line Tools，Windows 用 VS Build Tools，Linux 用 clang）
- Git 可用，磁盘至少留出 20 GB 空间
从零到跑通
取回代码
git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowy把完整源码拉到本地，后面的所有操作都在这个目录里进行。
装齐依赖
cd frontend/appflowy_flutter flutter pub get cd ../rust-lib cargo build第一条命令下载 Dart 侧依赖，第二条编译 Rust 核心；首次编译会下载上百个包，耐心等待即可。
本地跑起来
cd frontend/appflowy_flutter flutter run这一条会在当前系统上启动 AppFlowy，首次启动会进入预置的 Read me 工作区，点击任意位置即可开始敲字。
打包发布
flutter build macos --release flutter build windows --release flutter build linux --release按目标平台任选一条，构建产物会输出到 build 目录，可直接安装或分发给同事。
卡住了怎么办
flutter pub get报版本冲突或缺包：先flutter --version确认是 stable 渠道，再执行flutter pub cache clean清缓存重试。cargo build报 CMake 或链接器错误：说明系统编译器或 CMake 没装全，装好后跑flutter doctor再确认一遍。flutter run提示找不到设备：执行flutter config --enable-<平台>-desktop（如 linux）开启桌面支持，再重新运行。
📌 跑通之后，建议顺着仓库内的 doc/CONTRIBUTING.md 再看一眼贡献指南，或直接去项目官方社区提 issue、找答案——大多数你踩过的坑，别人都踩过。
【免费下载链接】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），仅供参考
