freeCodeCamp 课程源码解析：Use the parseInt Function with a Radix 挑战——掌握 parseInt() 的 radix 参数与进位制转换

本篇基于 freeCodeCamp 课程仓库中的实战挑战 587d7b7e367417b2b2512b22.md，完整讲解 parseInt() 第二个参数 radix（基数）的用法、进位制转换的计算原理，以及该挑战在课程结构中的组织方式。读完你可以：会用 parseInt(str, radix) 把任意 2～36 进制字符串转成十进制整数、理解测试断言如何验证转换结果，并掌握 freeCodeCamp 课程挑战文件的编写规范。

parseInt() 函数与 radix 参数

挑战的 description 部分给出核心定义：parseInt() 函数解析一个字符串并返回一个整数，它接受第二个参数 radix，用于指定字符串中数字所采用的进制（基数）。radix 的取值范围是 2 到 36 之间的整数。

函数调用形式为：

parseInt(string, radix);

课程给出的原始示例：

const a = parseInt("11", 2);

这里的 radix 声明了 "11" 是一个二进制（base 2）数，因此 parseInt("11", 2) 将字符串 "11" 转换为十进制整数 3，即 2¹ + 2⁰ = 3。如果不传 radix，parseInt 默认按十进制解析，"11" 就只是十进制的 11——这正是指定 radix 的意义：它消除了字符串数字的歧义，让解析结果与书写者意图的进制一致。

挑战任务与种子代码

挑战的 instructions 要求：在 convertToInteger 函数中使用 parseInt()，把一个二进制字符串转换为整数并返回。

种子代码如下，函数体留空等待填写：

function convertToInteger(str) {

}

convertToInteger("10011");

参考解决方案

官方 solutions 部分给出的实现只有一行核心逻辑：

function convertToInteger(str) {
  return parseInt(str, 2);
}

关键点在于第二个参数固定为 2：它告诉 parseInt 传入的 str 是二进制字符串。

测试断言与换算验证

挑战内置了 5 条断言，逐条覆盖了解析成功、类型正确、以及非法输入三种场景。逐条拆解如下：

1. 代码必须使用 parseInt——通过正则匹配源码（剔除注释后）来约束解法：

assert(/parseInt/g.test(__helpers.removeJSComments(code)));

2. 返回值必须是 number 类型：

assert(typeof convertToInteger('10011') === 'number');

3. 二进制换算正确性——"10011" 应返回 19：

assert(convertToInteger('10011') === 19);

换算过程：10011₂ = 2⁴ + 2¹ + 2⁰ = 16 + 2 + 1 = 19。

4. 第二组换算——"111001" 应返回 57：

assert(convertToInteger('111001') === 57);

换算过程：111001₂ = 2⁵ + 2⁴ + 2³ + 2⁰ = 32 + 16 + 8 + 1 = 57。

5. 非法输入返回 NaN——字符串以数字可解析字符无法起始时，parseInt 返回 NaN（Not-a-Number）：

assert.isNaN(convertToInteger('JamesBond'));

这条断言验证了错误处理的边界："JamesBond" 的首字符 J 不是合法的二进制数字，解析直接失败并返回 NaN，这是后续判断转换是否成功的标准依据。

该挑战在课程仓库中的组织方式

从仓库源码结构看，这道挑战属于典型的“程序化挑战”（challengeType: 1），文件头部 frontmatter 中的几个字段决定了它在课程中的身份与定位：

• id: 587d7b7e367417b2b2512b22：挑战的唯一标识，在 block 的 JSON 结构中按此 id 排序；
• dashedName: use-the-parseint-function-with-a-radix：用于生成 URL 路径的短横线命名；
• challengeType: 1：表示需要编写代码并通过断言验证的挑战类型；
• forumTopicId: 301182：关联的社区讨论主题编号。

在课程结构文件 basic-javascript.json 中，该挑战被排布在 587d7b7e367417b2b2512b23（"Use the parseInt Function"）之后、587d7b7e367417b2b2512b24（"Use the Conditional (Ternary) Operator"）之前。这种排序是有意设计的：先学不传 radix 的 parseInt("007") → 7 基础用法（见 587d7b7e367417b2b2512b23.md），再进阶到带 radix 的进制转换，形成递进关系。

整个 basic-javascript 块则隶属于 javascript-algorithms-and-data-structures.json 超块，是该超块的第一块。挑战文件的格式本身也受仓库内 JSON Schema 校验，相关定义见 challenge-schema.js，它规范了 description、instructions、hints、seed、solutions 等分区的结构，保证挑战内容能被课程构建工具正确解析。

延伸：parseInt(str, 2) 在课程中的实际应用

指定 radix 的 parseInt 并不只是练习题。从源码结构看，freeCodeCamp 后续课程模块中有多处以二进制字符串转整数为核心逻辑的内容，例如 learn-recursion-by-building-a-decimal-to-binary-converter 等挑战文件都直接使用了 parseInt 处理进位制转换，Roman Numeral Converter 项目 build-a-roman-numeral-converter-project 也涉及类似的字符串转整数技巧。可以说，本挑战掌握的 parseInt(str, 2) 是这些进阶内容的直接前置技能。

小结

• parseInt(string, radix) 的第二个参数 radix 决定进制，取值 2～36；
• parseInt("11", 2) 得到 3，radix 消除了字符串数字的进制歧义；
• 首字符无法解析时返回 NaN，应作为转换失败信号处理；
• 本课程挑战以 Markdown frontmatter（id、dashedName、challengeType、forumTopicId）+ 分区块（description/instructions/hints/seed/solutions）的格式组织，并在 basic-javascript.json 中按 id 排序入课。