Terragrunt日志自定义格式中tf-command-args占位符问题解析

Terragrunt作为Terraform的包装工具，在最新版本中增强了日志格式化功能，特别是对run-all命令的支持。然而，在v0.69.13版本中存在一个关于日志自定义格式占位符的重要问题需要开发者注意。

问题现象

当用户尝试使用--terragrunt-log-custom-format参数自定义日志格式时，文档中提到的%tf-command-args占位符实际上无法正常工作。具体表现为：

1. 使用%tf-command-args时，日志系统错误地将其解析为%t和后续字符
2. 系统错误提示中列出的可用占位符不包含tf-command-args
3. 而类似的%tf-path占位符却能正常工作

技术分析

这个问题源于代码实现上的一个疏漏。虽然tf-command-args占位符在字段定义文件中被声明，但未在占位符初始化函数中正确注册。具体来说：

1. 在字段定义文件中，tf-command-args确实被声明为一个有效字段
2. 但在占位符初始化函数newPlaceholders()中，缺少了对TFCmdArgsKeyName字段的注册
3. 这导致虽然功能设计上支持该占位符，但实际运行时系统无法识别

解决方案

该问题已在v0.70.2版本中得到修复。修复方案是在占位符初始化函数中正确添加了对TFCmdArgsKeyName字段的注册。修改后的初始化函数现在包含了对所有设计支持的占位符的完整注册。

对开发者的建议

1. 遇到类似日志格式化问题时，首先检查Terragrunt版本，确保使用最新稳定版
2. 自定义日志格式时，可通过故意使用错误占位符来查看系统支持的完整占位符列表
3. 对于关键功能，建议在升级后先进行简单测试验证功能可用性
4. 关注项目的更新日志，及时了解功能修复情况

这个问题虽然不大，但提醒我们在使用开源工具时，文档描述和实际实现可能存在细微差异，特别是在新功能刚发布时。保持工具更新和适当的功能验证是确保稳定使用的关键。