Logseq项目开发指南：静态资源依赖安装要点解析

在Logseq项目的开发过程中，运行Electron应用的端到端测试时，开发者可能会遇到应用窗口无法正常显示的问题。经过技术分析，发现这是由于项目静态资源目录中的依赖未正确安装导致的。

Logseq采用分层架构设计，其中static目录存放着前端静态资源，这些资源需要独立的依赖管理。与主项目使用yarn作为包管理器不同，static目录也维护着自己的package.json文件，这意味着开发者需要分别处理两个层级的依赖关系。

当执行Electron应用测试时，系统会同时调用主进程和渲染进程的代码。如果static目录的依赖缺失，渲染进程将无法正常初始化，从而导致应用窗口无法显示。这种架构设计在Electron应用中很常见，它实现了主进程和渲染进程的代码隔离。

解决方案很简单但容易被忽视：在项目根目录执行yarn install后，还需要进入static目录再次执行yarn install。这个步骤确保了渲染进程所需的所有前端依赖都被正确安装。

对于项目维护者来说，这个案例提醒我们在文档中需要明确说明多层级依赖管理的注意事项。完善的开发文档应该包含：

1. 项目目录结构的说明
2. 各层级的依赖管理方式
3. 测试前的完整环境准备流程

这个经验也适用于其他采用类似架构的Electron项目开发。理解项目的分层依赖关系，是保证开发环境正常工作的关键所在。