ESLint 报“Missing radix parameter“？一文搞懂原因与解决方案

在日常开发中，在使用parseInt函数转换字符串为整数时，会遇到ESLint抛出的"Missing radix parameter"提示。这时就会有疑惑：这到底是语法错误，还是单纯的代码规范问题？该如何快速解决？现在就来搞懂这个问题的来龙去脉。

一、问题："Missing radix parameter"是什么？

首先明确一点儿：这不是TypeScript/JavaScript语法错误，而是ESLint的代码规范警告。
比如下面的代码：

// 转换标签ID
const tagId = parseInt(data.tagId)

代码保存后，ESLint会直接标红提示"Missing radix parameter"，或代码提交时阻断流程，甚至在构建时阻断流程——但这段代码在浏览器中是正常运行的，那ESLint为什么要“吹毛求疵”？

二、问题根源：ESLint的“radix”规则

这个警告来自ESLint的核心规则radix，它的设计目的是强制规范parseInt函数的使用，避免潜在的解析歧义。

• 为什么需要“radix”参数？
  parseInt函数的完整语法如下：

parseInt(string: string, radix?: number): number

第二个参数radix代表“基数”（即进制），取值范围2-36，最常用的是10（十进制）。
如果不指定radix，parseInt的“隐藏逻辑”：

• 若字符串以 0x 开头，会按十六进制解析（如parseInt(“0x10”)j结果是16）
• 若字符串以 0 开头（非0x），旧浏览器会按八进制解析（如parseInt(“010”)结果是8，现代浏览器已修复为十进制，但规则扔为兼容保留）
• 其他情况按十进制解析。
  由于这个“不确定的解析逻辑”可能导致Bug，而ESLint的radix规则就是为了通过强制显示传参，消除这种歧义。

三、解决方案

显示指定radix参数
这是最符合规范、无副作用的方式——给parseInt加上第二个参数10（绝大多数场景适用）。
针对开头的问题代码，优化后：

const tagId = parseInt(data?.tagId || '', 10)

进一步优化：

const tagValue = data?.tagId;
const tagId = typeof tagValue === 'string' && ​tagValue.trim() !== '' ? parseInt(tagValue, 10) : 0

为什么这样处理？

• 明确基数10可以避免任何潜在的解析歧义
• TypeScript对这类代码规范有更严格的检查，有助于写出更可靠的代码
• 当tagValue为undefined时，parseInt(undefined, 10)会返回NaN，上面的优化代码可以通过默认值避免这种情况，先判断是否为非空字符串，用trim()排除""（纯空格字符串）这类隐性无效值，避免直接对“可能无效”的字符串调用parseInt

四、总结

ESLint的"Missing radix parameter"提示，本质是帮我们规避parseInt的解析歧义。记住两个核心点儿：

1. 日常开发中，parseInt必须显示传第二个参数10（十进制）
2. 若遇到该提示，优先补全参数，而非关闭规则。
   规范的代码写法，才是避免隐性Bug的关键~