Moon项目任务输出前缀不一致问题解析

问题背景

在Moon构建系统中，用户报告了一个关于任务输出前缀显示不一致的问题。具体表现为：当运行多个任务时，部分任务的输出没有按照预期添加前缀标识，导致开发者难以区分不同任务的输出内容。

问题现象

通过一个具体示例可以清晰展示这个问题：

# .moon/tasks.yml
tasks:
  foo:
    command: 'echo "foo running"'
  
  bug:
    command: 'echo "bug running"'
    options:
      cache: false
  
  lint:
    deps: [bug, foo]
    command: "echo 'lint running'"

当执行moon run ocio:lint -u命令时，输出如下：

bug running
▪▪▪▪ ocio:bug
▪▪▪▪ ocio:bug (2ms)
▪▪▪▪ ocio:foo (abe36ae1)
 ocio:foo | foo running
▪▪▪▪ ocio:foo (1ms, abe36ae1)
▪▪▪▪ ocio:lint (ef8141cc)
lint running
▪▪▪▪ ocio:lint (1ms, ef8141cc)

可以看到，"bug running"和"lint running"的输出没有前缀，而"foo running"则有ocio:foo |前缀。

问题分析

当前实现逻辑

Moon系统当前的行为逻辑是：

1. 当只运行单个任务时，不添加前缀
2. 当运行多个任务时，非主要目标任务的输出会添加前缀

这种设计最初是为了避免在运行单个任务（特别是服务器类任务）时，大量输出内容被不必要地添加前缀。

问题根源

1. 前缀逻辑不一致：当前实现基于命令行指定的目标数量来决定是否添加前缀，而不是基于实际执行的任务数量。这导致了当通过依赖关系间接执行多个任务时，部分输出没有前缀。

2. 缓存设置影响：当将bug.cache设置为true时，行为会发生变化，bug任务的输出会获得前缀，但lint任务仍然没有。这表明缓存设置意外影响了输出格式逻辑。

3. 用户体验问题：当多个任务并行执行时，没有前缀的输出难以追踪来源，违背了前缀设计的初衷。

解决方案

在Moon 1.31版本中，开发团队重新设计了这一逻辑：

1. 统一前缀规则：现在基于实际执行的任务数量来决定是否添加前缀，而不是命令行指定的目标数量。

2. 修复缓存影响：确保缓存设置不会意外影响输出格式。

3. 增强可读性：确保在多个任务并行执行时，所有输出都有清晰的前缀标识。

最佳实践建议

1. 对于需要清晰区分输出的场景，建议明确指定所有相关任务，而不是依赖隐式依赖关系。

2. 在定义任务时，考虑输出内容的可读性，可以手动添加前缀作为命令的一部分。

3. 对于服务器类或大量输出的任务，可以考虑使用日志文件而不是控制台输出。

总结

Moon项目通过1.31版本的改进，解决了任务输出前缀不一致的问题，使构建系统的输出更加一致和可读。这一改进体现了Moon团队对开发者体验的重视，也展示了构建系统设计中输出处理的重要性。