tbls项目中ER图列类型显示问题的分析与解决

问题背景

tbls是一个数据库文档生成工具，能够自动生成数据库结构的文档和ER图。在使用过程中，发现当配置文件中设置了include参数来筛选表时，ER图中showColumnTypes配置项（用于控制是否显示主键和外键之外的列）会失效。

问题现象

当用户通过.tbls.yml配置文件中的include参数筛选表时，即使设置了er.showColumnTypes.related和er.showColumnTypes.primary为true，ER图中仍然会显示所有列，而不是仅显示主键和外键列。而当include参数包含所有表（即使使用通配符）时，问题不会出现。

技术分析

通过查看源代码，发现问题出在列过滤逻辑上。在config/config.go和schema/filter.go文件中，列过滤的条件判断不够完善。原本的代码逻辑是：

if len(cc.ChildRelations) > 0 || len(cc.ParentRelations) > 0

这种判断方式在某些情况下会漏掉应该显示的列，特别是在表被筛选的情况下。

解决方案

项目维护者在v1.85.3版本中修复了这个问题。修复后的版本能够正确处理include参数和showColumnTypes配置的组合情况，确保ER图能够按照预期只显示主键和外键列。

延伸问题

虽然主问题已解决，但在Viewpoint页面的ER图中，showColumnTypes配置仍然会被忽略。这个问题与主问题类似，但发生在不同的上下文中，可能需要单独处理。

最佳实践建议

1. 当需要限制ER图中显示的列类型时，确保使用最新版本的tbls工具
2. 如果遇到类似问题，可以检查配置文件中的include和exclude参数是否与showColumnTypes配置产生冲突
3. 对于Viewpoint页面的显示问题，可以暂时通过手动筛选列或等待后续版本修复

总结

数据库文档工具的正确配置对于生成清晰、有用的文档至关重要。tbls项目团队对这类问题的快速响应展示了开源项目的优势。用户在使用时应关注版本更新，以获得最佳体验和功能支持。