【入门夯实】tonumber的进制参数：二至三十六进制的解析边界

学员常见误区

解析十六进制字符串时学员手写映射表逐字符转换——tonumber 自带进制参数：tonumber(s, base) 可解析 2 到 36 进制；常见错误是解析非法字符时不判 nil，直接参与算术报错。错误场景：

local input = "1G"
local n = tonumber(input, 16) + 1

G 不是合法的十六进制字符——tonumber 返回 nil，加法报 attempt to perform arithmetic on a nil value。

正确姿势

先接收 tonumber 的返回值判空，再做算术；非法输入走兜底分支。规范写法。示例代码如下：

local input = "1G"
local n = tonumber(input, 16)
if not n then
    print("非法的十六进制串")
    return
end
print(n + 1)

合法串 1F 解析得 31，非法串走提示分支——转换与校验一步完成。
引擎验证相关边界。示例代码如下：

print(tonumber("ff", 16), tonumber("777", 8), tonumber("101", 2))
print(tonumber("zz", 36))

输出 255、511、5 与 1295——36 进制里 z 是最大数字，进制上限 36。

引擎验证

三步验证：合法串按指定进制逐一解析对照；非法字符确认返回 nil 而非报错；缺省进制时带 0x 前缀串的返回值与带 16 进制参数的写法对比，记录引擎行为。

举一反三

进制解析配格式化输出可做进制互转工具。示例代码如下：

local dec = tonumber("1F", 16)
print(string.format("%X", dec), string.format("%o", dec))

输出 1F 与 37——format 的 %X %o 负责转出，tonumber 负责转入，一来一回完成进制互转。