NodeMCU中string.format处理浮点数格式异常问题咨询

我在NodeMCU环境下尝试把浮点数格式化为带符号、两位整数（不足补0）、两位小数的格式（比如+05.13或-05.13），但用string.format时得到了一堆不符合预期的异常结果：

h=5.127 -- 预期结果: +05.13
print(string.format("%+05.2f",h)) --> 05.13 （加号直接丢失了）
print(string.format("%+06.2f",h)) --> 005.13 （依然没有加号）

h=-5.127 -- 预期结果: -05.13
print(string.format("%05.2f",h)) --> -5.13 （整数部分没补0）
print(string.format("%06.2f",h)) --> 0-5.13 （补0位置完全错位，符号跑到中间了）

问题原因 #

这确实是当前NodeMCU版本里string.format的实现缺陷——它处理%+0X.Yf这类带符号的固定宽度浮点数格式时，没有把符号纳入整体宽度的计算逻辑，同时负数的补0规则也出现了错位，导致格式完全混乱。

解决方案 #

如果不想等官方修复，我们可以自己写自定义函数来实现需求，下面提供两种思路：

1. 针对固定格式的快速修复（两位整数+两位小数）

如果你的需求就是固定的(sign)xx.dd格式，这个简单函数就能解决问题：

function formatSignedFixed(num)
    local sign = num >= 0 and "+" or "-"
    local abs_num = math.abs(num)
    -- 拆分并格式化整数、小数部分，手动补0和拼接
    local int_part = string.format("%02d", math.floor(abs_num))
    -- 小数部分四舍五入到两位
    local frac_part = string.format("%02d", math.floor((abs_num - math.floor(abs_num)) * 100 + 0.5))
    return sign .. int_part .. "." .. frac_part
end

-- 测试验证
print(formatSignedFixed(5.127))  --> +05.13
print(formatSignedFixed(-5.127)) --> -05.13

2. 通用格式化函数（适配任意整数/小数位数）

如果需要灵活调整整数或小数的位数，这个通用函数更实用：

function formatSigned(num, int_digits, frac_digits)
    local sign = num >= 0 and "+" or "-"
    local abs_num = math.abs(num)
    -- 先对数值做四舍五入处理
    local rounded = math.floor(abs_num * 10^frac_digits + 0.5) / 10^frac_digits
    -- 拆分整数和小数部分
    local int_part = math.floor(rounded)
    local frac_part = math.floor((rounded - int_part) * 10^frac_digits)
    -- 按指定位数补0后拼接
    local fmt_int = string.format("%0"..int_digits.."d", int_part)
    local fmt_frac = string.format("%0"..frac_digits.."d", frac_part)
    return sign .. fmt_int .. "." .. fmt_frac
end

-- 测试原需求：两位整数+两位小数
print(formatSigned(5.127, 2, 2))  --> +05.13
print(formatSigned(-5.127, 2, 2)) --> -05.13
-- 扩展测试：三位整数+一位小数
print(formatSigned(12.34, 3, 1))  --> +012.3
print(formatSigned(-8.91, 3, 1))  --> -008.9

这些自定义函数完全绕过了NodeMCU原生string.format的缺陷，能稳定输出符合预期的格式。

内容的提问来源于stack exchange，提问作者eHc