Fastfetch用户模块格式化参数问题解析

在Fastfetch工具的用户模块中，存在一个格式化参数的小问题值得开发者注意。这个问题涉及到用户自定义输出时参数名的正确使用。

问题现象

当用户尝试使用users模块并自定义其输出格式时，按照文档说明应该使用{user-name}作为参数名来显示用户名。然而实际使用中发现这个参数名并不生效，而必须使用{1}才能正确显示用户名。通过查看源代码发现，正确的参数名实际上是{name}。

技术分析

Fastfetch的users模块负责显示系统用户信息，其格式化功能允许用户自定义输出样式。在格式化字符串中，开发者可以通过特定的占位符来插入各种用户信息。然而，文档中说明的占位符{user-name}与实现代码中的实际占位符{name}不一致，这导致了用户配置无法按预期工作。

这种参数名不一致的问题属于典型的文档与实现不同步的情况，虽然不影响核心功能，但会降低用户体验，特别是对于初次使用该模块的开发者。

解决方案

对于当前版本(2.30.1)，用户在使用users模块时应该注意：

1. 使用{name}作为用户名的占位符
2. 使用{host-name}作为主机名的占位符
3. 正确的格式化字符串示例应为：{name}@{host-name}

开发者建议

对于Fastfetch项目维护者，建议：

1. 统一文档和代码中的参数命名
2. 考虑保持向后兼容性，同时支持{user-name}和{name}两种形式
3. 在文档中明确列出所有可用的格式化参数

这种小问题的修复虽然简单，但对于提升用户体验和项目专业性有着重要意义。作为开源项目，保持文档与实现的一致性是一个持续的过程，需要开发者社区的共同努力。