Moon项目中的任务定义错误处理与令牌解析优化

在Moon项目构建系统中，任务定义是核心功能之一。近期发现了一个关于任务定义中令牌解析和错误处理的优化点，值得开发者关注。

问题背景

在Moon项目的任务定义中，开发者可以使用@in和@out等令牌来引用输入输出文件。然而，当这些令牌引用非法或配置错误时，系统报错信息不够明确，且令牌嵌套使用存在限制。

错误处理改进

当前版本中，当任务定义包含非法令牌引用时，错误信息仅显示令牌解析失败，但不指明具体是哪个任务导致了问题。例如：

tasks:
  lint:
    script: npx redocly lint --config @in(0) @in(1)
    inputs:
      - "@files(srcConfig)"
      - "@files(sources)"

当运行moon query tasks命令时，系统会报错：

Error: token_expander::invalid_index_reference
× Token @in(0) is referencing another token or an invalid value. Only file paths or globs can be referenced by index.

改进方向是让错误信息包含任务名称，帮助开发者快速定位问题源。

令牌解析优化

另一个重要改进点是允许@in和@out令牌在命令/脚本定义中引用其他令牌定义的输入输出。当前版本中，当输入输出本身通过令牌定义时，无法在脚本中再次使用@in或@out引用它们。

这种限制实际上是不必要的，因为文件组定义不允许递归令牌，所以最多只需要两层解析即可确定最终值。移除这一限制将提高配置的灵活性，使开发者能够构建更复杂的任务依赖关系。

技术实现要点

1. 错误上下文增强：在项目图创建阶段捕获并附加任务名称信息到错误中
2. 令牌解析改进：实现递归令牌解析，但限制递归深度以防止无限循环
3. 配置验证：在早期阶段验证令牌引用的合法性，尽早发现问题

对开发者的影响

这些改进将使Moon项目的任务配置更加灵活和友好。开发者可以：

• 更快速地诊断和修复配置问题
• 构建更复杂的任务依赖链
• 减少因模糊错误信息导致的调试时间

最佳实践建议

1. 始终为关键任务提供有意义的名称
2. 在复杂任务链中，逐步验证各环节配置
3. 利用文件组和令牌的组合提高配置的可维护性

这些改进体现了Moon项目对开发者体验的持续关注，使构建系统更加健壮和易用。