【Lua实战】string.format 的对齐与千分位：战报排版

实战应用：用在哪里

战报与榜单的可读性是排版功力：一百万的伤害显示成 1000000 是灾难，对不齐的榜单让人眼晕。string.format 的对齐与精度控制是排版的刻刀，数字的千分位与列的对齐全靠它。

数字的千分位

---千分位：Lua 没有内置，手写分组
local function thousand(n)
    local s = tostring(math.floor(n))
    local out = s:reverse():gsub("(%d%d%d)", "%1,"):reverse()
    return (out:gsub("^,", ""))
end

print(thousand(1234567))      -- 1,234,567
print(thousand(98765))        -- 98,765

---格式化的对齐：榜单的三列
local function row(rank, name, dmg)
    return string.format("%-4d%-12s%15s",
        rank, name, thousand(dmg))
end

千分位的实现用反转分组的技巧：数字转串后反转、每三位插逗号、再反转回来——Lua 没有内置的千分位，八行的手写是标准解。format 的对齐控制：%-4d 左对齐占 4 位、%15s 右对齐占 15 位，榜单的三列（名次、名字、伤害）在对齐的格式串里各归其位。宽度的选择按数据的极值定：名字的列宽按最长的合法名字（16 字符）留足，溢出的截断加省略号。

精度的控制

---浮点的精度：伤害统计的小数位
local function dps(total, seconds)
    return string.format("%.1f", total / seconds)
end

---百分比的呈现：胜率的两位小数
local function ratePct(win, total)
    return string.format("%.2f%%", win / total * 100)
end

---战报的整行组装
local function battleLine(name, dmg, heal)
    return string.format("%s  伤害 %s  治疗 %s",
        name, thousand(dmg), thousand(heal))
end

精度的控制按语义定：DPS 保留一位小数（0.1 的精度够用）、胜率保留两位（微小的差距要可见）、金币与伤害永远是整数——小数出现在金币里是Bug不是精度。format 的转义陷阱：百分号本身要用 %% 输出，百分比与格式符混排的字符串容易漏写。排版的性能在热路径的提醒：战报的组装在战斗结束时一次生成，逐帧的格式化是不必要的浪费——format 的调用时机挑在数据的节点而不是渲染的循环。

验证与监控

排版函数的单测覆盖边界：零、负数、极大值、小数进位、空名字；战报的显示宽度抽检，超宽的行在客户端的截断表现纳入验收。

踩坑记录

千分位的分组曾经没处理小数部分，带小数的数值分组错位，先取整再分组的顺序固化。对齐的宽度曾经按中文名算一个字符，UTF-8 的中文宽度是英文的两倍，显示宽度按字节的两倍估。format 的参数曾经个数不匹配，多余的参数被静默忽略，格式串与参数的配对进单测。

上线要点

排版的工具函数进公共库：千分位、百分比、对齐三件套统一维护。榜单与战报的列宽进皮肤配置，分辨率的适配不动逻辑。数字的呈现规范进设计文档：什么数值用小数、什么数值永远整数，口径全服统一。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。