AFFiNE 拉取最新 canary 后应用无法启动怎么排查？重跑依赖安装与 native 构建-北京尧图网络

AFFiNE 拉取最新 canary 后应用无法启动怎么排查重跑依赖安装与 native 构建【免费下载链接】AFFiNEThere can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.项目地址: https://gitcode.com/GitHub_Trending/af/AFFiNE在 AFFiNE 仓库中拉取了最新的canary分支默认开发分支之后启动应用失败。docs/BUILDING.md的 Troubleshooting 一节明确给出了这个现象的处理方式App fails to start after pulling the latestcanary—— 依赖或 Rust bindings 可能发生了变化需要重跑yarn install和yarn affine affine/native build。本文按这条路径走一遍先核对工具链版本再重跑依赖安装与 native 构建最后用开发服务器验证应用能否正常启动。该流程基于 docs/BUILDING.md面向从源码构建、运行 AFFiNE web app 的开发者。先核对工具链Node、Yarn 与 Rustcanary 分支更新后最常见的安装/构建阶段就报错根源是工具链版本不匹配。BUILDING.md要求Node.js版本由.nvmrc固定当前为22.23.2package.json的engines字段要求22.12.0 23.0.0。用版本管理器对齐# 二选一 fnm use --install-if-missing nvm install nvm useYarn使用现代 Yarn4.x由package.json的packageManager字段固定为yarn4.18.0Yarn 1 不可用。通过 Node.js 自带的 Corepack 启用corepack enable执行后用yarn -v验证输出应为4.x而不是1.x。Rust通过 rustup 中当前 channel 为1.97.1在仓库内首次构建时 rustup 会自动安装。Troubleshooting 一节也指出如果yarn install本身失败并报 Node/Yarn 版本相关错误先检查node -v是否与.nvmrc一致、Corepack 是否已启用yarn -v应输出4.x。也就是说重跑安装前先过一遍上面的核对避免把环境问题误判为应用启动问题。第一步重跑依赖安装yarn install注意这个命令的实际作用不止安装依赖postinstall脚本还会初始化 workspaceyarn affine init并通过 git hooks 安装 husky见package.json中的postinstall: yarn affine init yarn husky。canary 更新可能同时改动了 workspace 结构所以这一步需要完整跑完而不是在旧node_modules上跳过。第二步重建 native 模块依赖装好后重建 Rust 编写的 native 模块yarn affine affine/native build该命令构建packages/frontend/native下的 native 模块并用 NAPI.rs 生成 Node.js 绑定其底层脚本为napi build -p affine_native --platform --release --strip见packages/frontend/native的package.json。首次构建耗时可能较长。macOS 用户确保strip命令使用的是系统自带的而不是binutils提供的BUILDING.md在该步骤和 Troubleshooting 中均专门提示了这一点。可选分支如果你要运行本地 server账号、同步、协作等 cloud 功能或跑 cloud E2E 套件还需要额外构建 server 的 native 依赖yarn affine affine/server-native build只跑 web app、不依赖本地 server 时无需此步。启动开发服务器验证重建完成后按文档正常启动流程验证应用yarn dev执行后会提示选择要运行的包——选择affine/webweb app然后打开http://localhost:8080。想跳过交互提示可以用-p--package参数yarn dev -p affine/web能打开localhost:8080上的 web app说明 canary 更新后的依赖与 native 构建已恢复正常。文档说明单独运行affine/web足以覆盖大多数编辑器与 UI 工作workspace 数据保存在浏览器本地如果要开发 cloud 功能账号、同步、协作、AI需要再按 docs/developing-server.md 启动本地 server这属于另一条任务路径不在本次启动排查范围内。仍无法启动时的检查项按 docs/BUILDING.md Troubleshooting 一节逐项核对yarn install失败或抱怨 Node/Yarn 版本确认node -v与.nvmrc一致fnm use/nvm use且yarn -v输出4.x而非1.x。native 模块在 macOS 上构建失败确认strip是系统版本而非binutils的。桌面客户端ElectronBUILDING.md面向 web app构建桌面客户端的流程见 docs/building-desktop-client-app.md其中 native 模块构建与本文第二步相同区别在于 core 与 electron 打包需要分别调整 yarn 配置。最后注意BUILDING.md开头的声明该文档不保证始终最新如果按上述步骤操作后仍然失败、或发现文档内容过期文档建议的做法是提交 issue 或 PR 更新它。【免费下载链接】AFFiNEThere can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.项目地址: https://gitcode.com/GitHub_Trending/af/AFFiNE创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

AFFiNE 拉取最新 canary 后应用无法启动怎么排查？重跑依赖安装与 native 构建

相关推荐

AI“差不多先生”：幻觉、套壳与落地之殇

SNMP测试工具全解析：从协议基础到排障实战

HBase迁移方案设计：跨版本升级、跨集群迁移与数据校验

更多资讯

Gemini API JSON 文本摘要实战：3 步把长文本变成结构化数据

JAVA毕设项目：基于SpringBoot的高校仪器设备共享预约管理系统的设计与实现基于SpringBoot的实验设备资源共享预约服务系统的设计与实现 (源码+文档，讲解、调试运行，定制等)

JAVA毕设项目：基于SpringBoot的大数据学习资源推荐系统的设计与实现基于SpringBoot的自适应学习资源推荐系统的设计与实现 (源码+文档，讲解、调试运行，定制等)

JAVA毕设项目：依托SpringBoot与Vue技术的企业职工健康数字化监管平台构建企业智能化办公下职工健康监护信息管理系统的研发与实践 (源码+文档，讲解、调试运行，定制等)

JAVA毕设项目：Vue前端可视化+SpringBoot后端赋能的职工健康监护管理系统研发实践面向职工健康数据监管的智能化管理系统设计 (源码+文档，讲解、调试运行，定制等)

如何在 tests/ui 中用 minicore 编写 ![no_std] 的跨编译测试？

今日更新

在S3C2410上移植Nucleus RTOS：启动、驱动与实时性调优实战

2026年Turnitin降重降AI二合一红黑榜：能过和别碰

2026期刊投稿AI写作工具实测：6款打分谁更值得用

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？