ActualBudget项目构建体积优化实践

背景介绍

ActualBudget是一款开源的预算管理工具，近期有用户反馈在从25.3.1版本升级到25.4.0版本时，构建产物体积从160MB激增至1.8GB。这一变化源于构建流程的调整，本文将深入分析问题原因并提供优化方案。

问题分析

在25.3.1版本中，构建流程使用Yarn Workspaces的focus命令，仅安装生产环境所需的依赖：

yarn workspaces focus @actual-app/sync-server --production

而25.4.0版本改为完整的安装和构建流程：

yarn install
yarn build:server

这种变化导致Yarn安装了所有开发依赖，包括测试工具、构建工具等非必要组件，使得最终构建产物膨胀了10倍以上。

优化方案

方案一：回归精简构建流程

通过分析项目的Dockerfile，可以重构一个精简的构建脚本：

#!/usr/bin/env bash
set -e

# 安装依赖
yarn install

# 构建浏览器端代码
yarn build:browser

# 聚焦生产环境依赖
yarn workspaces focus @actual-app/sync-server --production

# 准备生产目录
BUILD_DIR=build
mkdir -p $BUILD_DIR
cp -r node_modules $BUILD_DIR/
cp packages/sync-server/{package.json,app.js} $BUILD_DIR/
cp -r packages/sync-server/src $BUILD_DIR/
cp -r packages/sync-server/migrations $BUILD_DIR/

# 清理不必要的符号链接
rm -rf $BUILD_DIR/node_modules/@actual-app/web $BUILD_DIR/node_modules/@actual-app/sync-server

# 手动复制必要的前端构建产物
mkdir -p $BUILD_DIR/node_modules/@actual-app/web
cp packages/desktop-client/package.json $BUILD_DIR/node_modules/@actual-app/web/package.json
cp -r packages/desktop-client/build $BUILD_DIR/node_modules/@actual-app/web/

这个脚本通过以下方式优化构建体积：

1. 使用focus命令仅保留生产依赖
2. 手动复制必要的构建产物
3. 清理非必要的符号链接

方案二：等待官方CLI工具

项目维护团队正在开发一个专用的CLI工具，预计在25.5.0版本发布。该工具将：

• 简化安装流程
• 减少依赖项
• 最终体积约75MB
• 无需手动构建

技术原理

Yarn Workspaces的focus命令通过分析package.json中的dependencies字段，仅安装生产环境必需的依赖包。而完整的yarn install则会安装devDependencies中的所有开发工具，包括：

• 测试框架
• 构建工具
• 类型定义文件
• 开发服务器等

这些开发工具在运行时并不需要，但会显著增加构建体积。

实践建议

对于需要自建服务的用户，建议：

1. 短期方案：使用上述精简构建脚本
2. 长期方案：等待官方CLI工具发布
3. 监控构建产物中的node_modules体积
4. 定期清理不必要的缓存文件

总结

构建工具链的配置对最终产物体积有重大影响。通过合理使用包管理器的功能，可以显著优化部署包的大小。ActualBudget团队已经意识到这个问题，并将在未来版本中提供更优雅的解决方案。在此期间，用户可以采用本文提供的优化方案来控制构建体积。