AppFlowy 安装完整教程：新手从源码编译到打开桌面端的 4 步路径

AppFlowy 安装完整教程新手从源码编译到打开桌面端的 4 步路径【免费下载链接】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 助手离线也能写。这篇文章按先选型、再装工具链、然后编译、最后配置的顺序走一遍每一步都给出可核对的结果方便你随时确认没有走偏。一分钟选对安装方式AppFlowy 有三种获得方式先判断你的目的再决定走哪条路。方式适合谁耗时特点预编译安装包只想用不想碰代码约 5 分钟官网提供 macOS、Windows、Linux 桌面端移动端在应用商店可搜到源码编译想改界面、加功能、给项目提 PR首次 1~2 小时需要 Flutter 和 Rust 两套工具链编译产物完全自己可控移动端直接装只想手机上随手记几分钟与桌面端数据不自动互通除非登录同一个云账号如果你要参与开发或二次改造源码编译是绕不开的路下文全部围绕它展开。选安装包的朋友装完就能直接用可以跳到打开后必做的三件事一节。这套架构决定了你为什么要装两套工具链界面层用 FlutterDart写业务核心用 Rust 写前端通过 FFI 调用 Rust 编译出来的原生库。工具链只装两样版本别装错Flutter 要 3.27.4 或更新项目对 Flutter 的约束是3.27.4见frontend/appflowy_flutter/pubspec.yaml的 environment 段。装 3.27.x 之后的任意版本都可以太旧会在 pub get 阶段直接报环境不满足。验证flutter --version输出 3.27.4 及以上即算通过。Rust 让 rustup 帮你锁定 1.85仓库根目录的rust-toolchain.toml把 Rust 版本锁在 1.85。只要用 rustup 管理 Rust进入frontend/目录后它会自动下载并切换到 1.85不需要你手动选版本。curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh source $HOME/.cargo/env cd frontend rustup showrustup show输出里出现active toolchain: 1.85即表示成功。如果显示下载失败多半是网络问题配置 Rust 镜像源后重试即可。补一个构建工具 cargo-make项目用 cargo-make 编排编译任务任务定义在frontend/scripts/makefile/下装它只需一条命令cargo install cargo-make装完后cargo make --version能输出版本号即可。从克隆到打开应用4 步跑通桌面端第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/ap/AppFlowy cd AppFlowyls frontend能看到appflowy_flutter和rust-lib两个目录即克隆完整。第二步拉取 Dart 依赖先做快速体检cd frontend/appflowy_flutter flutter pub getpubspec.yaml里有几个依赖来自 git 仓库如appflowy-board如果这一步卡住或超时基本是网络访问 git 源的问题后面排查一节有对应方案。输出Got dependencies in ...表示通过。第三步执行整体构建cd frontend cargo make appflowy这个任务会按顺序完成代码生成、编译 Rust 核心库、构建 Flutter 应用最后产出安装包。首次构建要下载并编译上百个 Rust crate30 分钟起步属于正常现象中途不要中断。构建成功后会在build/目录下生成对应平台的产物macOS 为.appLinux 为压缩包Windows 为可执行程序。第四步打开它。直接运行上一步的产物即可如果你想边改代码边看效果用开发模式更快cd frontend/appflowy_flutter flutter run开发模式下 Rust 核心库由构建系统按需增量编译改一行 Dart 代码热重载就能生效适合调试界面。看到 AppFlowy 的启动画面出现整条链路就通了。打开后必做的三件事第一件确认存储模式AppFlowy 默认纯本地运行不需要注册账号就能用所有数据存在本机应用数据目录macOS 为~/Library/Application Support/io.appflowy.AppFlowyLinux 为~/.local/share/io.appflowy.AppFlowy。想后续多设备同步才需要登录云账号登录是可选项不是前提。第二件配置 AI 功能进设置 → AppFlowy AI填入自己的模型服务 API Key如 OpenAI、Gemini 等。注意两点Key 只存在本地配置里AI 请求由设备直接发给模型服务商文档内容不经过 AppFlowy 的服务器。配置完成后在文档里选中一段文字调用 AI 摘要能返回结果就算配通。第三件建一个文档再切一个数据库新建一篇文档随便写两行然后在侧边栏把视图切换成数据库表格/看板再建一条记录。这两个动作能把编辑器、本地 SQLite 存储、视图渲染都跑一遍等价于一次冒烟测试。卡住了对照这张表排查现象原因处理办法flutter pub get卡在 git 依赖上部分依赖托管在 git 仓库网络不通用git config --global url.....insteadOf https://github.com/配置可用镜像再重试进入目录后 Rust 报 toolchain 不存在rustup 尚未下载 1.85手动执行rustup toolchain install 1.85确认网络或镜像源正常Linux 上编译 Rust 库报缺 clang、GTK、cmake系统缺少原生构建依赖参考frontend/scripts/install_dev_env/install_linux.sh里的包清单用发行版包管理器补齐后重试cargo make提示 command not found没装 cargo-make 或不在 PATHcargo install cargo-make装完重开终端首次构建超过 1 小时还没动静正常首次全量编译就是慢看磁盘占用还在增长就说明没卡死后续增量构建通常在几分钟内完成两个下一步把应用数据目录加进你的备份计划。AppFlowy 的数据就是一个可复制的目录定期拷贝一次是最简单可靠的备份方式。想改代码的话从frontend/appflowy_flutter/lib/plugins/入手看界面逻辑从frontend/rust-lib/看业务核心两边对照着读比单看一边快得多。【免费下载链接】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），仅供参考