FigmaToCode项目构建问题分析与解决方案

项目构建环境配置问题

FigmaToCode项目近期从Webpack和Rollup迁移到了TurboRepo构建系统，但相关文档尚未完全更新，导致新贡献者在构建过程中遇到了一系列问题。本文总结了主要问题及其解决方案。

主要构建问题

1. 构建工具变更：项目已从Webpack/Rollup转向TurboRepo，但README文档仍保留旧构建工具的说明，容易误导开发者。

2. TurboRepo配置问题：

   • 缺少packageManager字段导致构建失败
   • TurboRepo 2.0将pipeline重命名为tasks，但配置未更新
   • 缺少dev和build:watch等常用任务定义

3. Node版本要求：构建需要Node.js v18.17.0以上版本，但文档未明确说明最低版本要求。

4. ESLint配置问题：使用了已弃用的配置选项useEslintrc和extensions。

解决方案与最佳实践

1. 环境准备：

   • 确保Node.js版本≥18.17.0
   • 使用pnpm作为包管理器

2. TurboRepo配置更新：

{
  "tasks": {
    "dev": {
      "cache": false,
      "persistent": true
    },
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    }
  }
}

3. 构建命令调整：

   • 开发模式：pnpm dev
   • 生产构建：pnpm build
   • 调试模式：从插件目录直接运行

4. ESLint配置修正：

   • 移除已弃用的useEslintrc和extensions选项
   • 更新为最新ESLint推荐配置

给贡献者的建议

1. 在开始贡献前，先检查项目最新的构建系统要求
2. 遇到构建问题时，可参考TurboRepo 2.0的官方迁移指南
3. 开发过程中，优先使用插件目录下的调试模式进行测试
4. 提交PR前，确保本地构建和测试全部通过

项目维护者已确认这些问题，并计划更新相关文档和配置。新贡献者可按照上述解决方案进行环境配置和项目构建。