StyLua项目中输出格式与检查标志的关联问题解析

问题背景

在代码格式化工具StyLua的使用过程中，开发者发现了一个关于输出格式与检查标志关联性的问题。当用户尝试使用--output-format=summary参数而不启用--check标志时，系统会返回一个不准确的错误提示。

问题现象

具体表现为：执行命令stylua --output-format=summary file.lua时，系统返回错误信息：

error: --output-format=unified and --output-format=standard can only be used when --check is enabled

这个错误信息存在两个明显问题：

1. 错误信息中提到了unified和standard格式，但实际触发错误的是summary格式
2. 错误信息与实际情况不符，造成了用户困惑

技术分析

通过查看源代码发现，该检查逻辑位于主程序的核心部分。系统会验证当check标志未启用时，是否使用了特定的输出格式。代码中明确检查了Unified和Summary两种格式，但错误信息却没有正确反映这一点。

问题根源

经过项目维护者的确认，这确实是一个错误消息不准确的问题。设计意图是：summary输出格式确实应该只在启用check标志时使用，这与unified格式的行为一致。因此，错误信息应该包含summary而非standard。

解决方案

正确的错误信息应该是：

error: --output-format=unified and --output-format=summary can only be used when --check is enabled

这一修正将准确反映实际的约束条件，帮助用户正确理解工具的使用限制。

设计考量

这种限制的设计背后可能有以下考虑：

1. summary和unified格式通常用于CI/CD环境中的格式检查
2. 这些格式提供了更适合自动化处理的输出结构
3. 在非检查模式下使用这些格式可能没有实际意义

最佳实践建议

对于StyLua用户，建议：

1. 在CI/CD流程中同时使用--check和--output-format=summary
2. 在本地开发时，可以使用默认输出格式或standard格式
3. 注意不同输出格式适用的不同场景

这个问题的发现和修复过程展示了开源社区如何协作改进工具，也提醒我们在设计CLI工具时，错误信息准确性的重要性。