JS字符串内置方法substring与substr的用法区别

作者:木棉时间:2026-11-18 18:42:59浏览:664

详细解析JavaScript字符串内置方法substring与substr在第二个参数含义、负数处理、参数顺序自动交换及标准支持状态上的核心区别,并提供完整代码示例与代码迁移重构步骤。

在 JavaScript 中,substring 和 substr 都用于从原字符串中截取子字符串,且都不会修改原字符串,但两者的核心区别在于第二个参数的含义不同、对负数的处理规则不同以及参数大小颠倒时的行为不同:substring(indexStart, indexEnd) 接收的是“起始索引”与“结束索引(不含)”,会将负数归零并在起始索引大于结束索引时自动调换两者;而 substr(from, length) 接收的是“起始索引”与“截取字符个数”,允许第一个参数使用负数表示从末尾倒数。由于 substr 已被 ECMAScript 标准归入遗留特性(Annex B),新代码应优先使用 substring 或 slice。

一、最核心的区别:第二个参数代表“结束位置”还是“截取长度”

初学者最容易混淆的地方,在于两个方法都接收两个数字参数,而且第一个参数都代表起始索引(从 0 开始计数)。只要传入相同的两个正整数,返回结果往往完全不同,原因就在于第二个参数的计算基准不同。

str.substring(indexStart, indexEnd) 的第二个参数 indexEnd 是结束位置的索引号。截取范围遵循“左闭右开”原则,即包含 indexStart 位置的字符,但不包含 indexEnd 位置的字符,最终截取出的字符个数等于 indexEnd - indexStart。

str.substr(from, length) 的第二个参数 length 则是要截取的字符数量。它从 from 索引位置开始,向后连续数出 length 个字符并返回,不需要开发者手动计算结束位置的下标。

JS字符串内置方法substring与substr的用法区别
图 1:对字符串 "JavaScript" 分别调用 substring(4, 7) 与 substr(4, 7) 的作用区间对比

下面通过一段可在浏览器控制台(按 F12 打开 DevTools Console)或 Node.js 环境中直接运行的代码,验证两者在常规正整数参数下的表现:

const str = "JavaScript";

// 1. 传入两个参数:起始位置与结束位置 vs 起始位置与截取长度
const resSubstring = str.substring(4, 7);
const resSubstr = str.substr(4, 7);

console.log("substring(4, 7):", resSubstring);
console.log("substr(4, 7):", resSubstr);

// 2. 若想用 substr 同样截取出 "Scr"(3个字符),第二个参数应传 3
console.log("substr(4, 3):", str.substr(4, 3));

// 3. 省略第二个参数时,两者行为一致:都从起始索引一直截取到字符串末尾
console.log("substring(4):", str.substring(4));
console.log("substr(4):", str.substr(4));
示例输出

substring(4, 7): Scr
substr(4, 7): Script
substr(4, 3): Scr
substring(4): Script
substr(4): Script

可以看到,当省略第二个参数时,str.substring(4) 和 str.substr(4) 没有任何区别,都会从索引 4 一直截取到字符串末尾;只有当显式传入第二个参数时,两者的计算逻辑才会分道扬镳。

二、参数大小颠倒与边界值:substring 的自动交换机制

在实际开发中,起始索引和结束索引有时来自变量计算(例如动态搜索两个分隔符的位置),可能出现“第一个参数大于第二个参数”或者“参数为负数、NaN”的情况。substring 和 substr 对这类边界值的处理规则完全不同。

substring(indexStart, indexEnd) 内部有一套严格的规范化流程:

  • 负数或 NaN 归零:只要任一参数小于 0 或为 NaN,都会先被强制当作 0 处理。
  • 超长截断:只要任一参数大于字符串长度 str.length,会被截断为 str.length。
  • 大小颠倒时自动交换:如果规范化之后的 indexStart > indexEnd,substring 会自动调换这两个参数的位置,即 str.substring(7, 4) 等同于执行 str.substring(4, 7)。

而 substr(from, length) 不会交换参数顺序,因为它的两个参数含义不同(一个是位置,一个是长度),不存在互换逻辑。当第二个参数 length 小于或等于 0、或者为 NaN 时,无论第一个参数是多少,substr 都会认为需要截取 0 个字符,直接返回空字符串 ""。

JS字符串内置方法substring与substr的用法区别
图 2:substring 处理负数、越界值与逆序参数的四步内部推导流程

这种“负数变 0 + 自动交换顺序”的组合机制,常常制造一个让人意外的现象:调用 str.substring(4, -2) 时,结果并不是空字符串,而是从索引 0 到索引 4 的前缀子串。因为 -2 先变成了 0,式子变成 str.substring(4, 0),随后触发自动交换变成 str.substring(0, 4)。请看以下代码验证:

const str = "JavaScript";

// 1. 第一个参数大于第二个参数
console.log("substring(7, 4):", str.substring(7, 4)); // 自动交换为 substring(4, 7)
console.log("substr(7, 4):", str.substr(7, 4));       // 从索引 7 开始取 4 个字符

// 2. 第二个参数为负数
console.log("substring(4, -2):", str.substring(4, -2)); // 先变为 (4, 0),再交换为 (0, 4)
console.log("substr(4, -2):", JSON.stringify(str.substr(4, -2))); // 长度 <= 0,返回空字符串 ""
示例输出

substring(7, 4): Scr
substr(7, 4): ipt
substring(4, -2): Java
substr(4, -2): ""

三、负数起始索引:如何正确从字符串末尾倒数截取

很多开发者需要截取字符串末尾的若干个字符(比如获取文件扩展名或手机号后四位),直觉上会尝试传入负数作为第一个参数。这时 substring、substr 和 slice 的表现差异非常明显:

  • substring 完全不支持负数倒数:所有负数都会被直接当作 0。因此 "JavaScript".substring(-6) 实际执行的是 substring(0),返回整个字符串。
  • substr 的第一个参数支持负数倒数:当 from < 0 时,起始位置按 str.length + from 计算(即从末尾往前数 |from| 个字符);如果倒数超出了字符串总长度(即 str.length + from < 0),则从 0 开始。
  • slice 的两个参数都支持负数倒数:不仅起始位置支持负数倒数,结束位置也支持负数倒数,且属于 ECMAScript 核心标准方法。
JS字符串内置方法substring与substr的用法区别
图 3:负数索引在 substring、substr 与 slice 中的转换规则与返回结果对比
容易出错的地方:不要用 substring 传负数截取末尾字符 如果业务需求是“截取字符串最后 4 位”,写下 str.substring(-4) 会直接返回完整的原字符串,且不会抛出任何语法或运行时错误。需要用倒数索引时,应使用 str.slice(-4),或者显式写成 str.substring(str.length - 4)。

四、为什么不建议在新项目中使用 substr,以及如何迁移

除了参数行为的差异,两者在语言标准中的地位也有重要区别:String.prototype.substring 是 ECMAScript 核心规范一直保留的标准方法;而 String.prototype.substr 已被移入 ECMAScript 规范的 Annex B(用于 Web 浏览器兼容性的遗留特性附录),在 MDN 官方文档及主流代码检查工具(如 ESLint、TypeScript 编译器提示)中均被标记为 Deprecated(已弃用)。

虽然各大浏览器引擎为了兼容海量历史网页,短期内不会彻底移除 substr,但在新编写的业务代码或开启了严格 Lint 规则的工程中,应当避免继续使用 substr。如果你正在维护旧项目,可以按照以下规则将现有的 substr 安全替换为标准方法:

  1. 只传了一个非负参数 str.substr(start):直接将方法名替换为 str.substring(start) 或 str.slice(start),行为完全一致。
  2. 传了起始位置与固定长度 str.substr(start, len)(且 start >= 0, len >= 0):将第二个参数从“长度”改写为“起始位置 + 长度”,即替换为 str.substring(start, start + len)。
  3. 第一个参数使用了负数倒数 str.substr(-n):直接替换为 str.slice(-n)。
  4. 第一个参数为负数且同时指定了截取长度 str.substr(-n, len):可先计算出非负起点 const start = Math.max(str.length - n, 0),再调用 str.slice(start, start + len)。
const fileName = "report_2026_final.pdf";

// 场景 1:旧代码用 substr 从指定位置取固定长度 (从索引 7 开始取 4 位年份)
const yearOld = fileName.substr(7, 4);
// 迁移写法:将 (start, len) 改为 (start, start + len)
const yearNew = fileName.substring(7, 7 + 4);

console.log("年份截取对比:", yearOld, "vs", yearNew);

// 场景 2:旧代码用 substr 传负数获取末尾扩展名
const extOld = fileName.substr(-3);
// 迁移写法:使用标准方法 slice 处理负数倒数
const extNew = fileName.slice(-3);

console.log("扩展名截取对比:", extOld, "vs", extNew);
示例输出

年份截取对比: 2026 vs 2026
扩展名截取对比: pdf vs pdf

五、全面对比与日常选型总结

为了在日常编码与排查 Bug 时快速确认行为,下表整理了 substring、substr 以及常用来替代 substr 的 slice 在各项边界条件下的表现:

对比维度 substring(start, end) substr(from, length) slice(start, end)
第二个参数含义 结束索引(不包含该位置字符) 要截取的字符个数(长度) 结束索引(不包含该位置字符)
省略第二个参数 截取到字符串末尾 截取到字符串末尾 截取到字符串末尾
第一个参数为负数 直接归 0 从末尾倒数(str.length + from) 从末尾倒数(str.length + start)
第二个参数为负数 先归 0,再与第一个参数比较并交换 视为截取长度 <= 0,返回 "" 从末尾倒数计算结束索引
参数1 > 参数2 时 自动交换两个参数的位置 不交换,按各自定义正常执行 不交换,直接返回空字符串 ""
ECMAScript 标准状态 核心标准方法(推荐使用) Annex B 遗留特性(已弃用,不推荐新写) 核心标准方法(推荐使用)
JS字符串内置方法substring与substr的用法区别
图 4:根据实际业务需求选择 substring、slice 及迁移旧版 substr 的决策总结

总结来说,阅读旧代码时只需记住 substring 第二个参数是结束下标、substr 第二个参数是截取字符个数;而在编写新代码时,如果明确使用非负索引区间,使用 substring(start, end) 即可;如果需要利用负数从字符串末尾倒数截取,则应统一使用 slice,不再新增 substr 调用。

作者最新文章
相关文章
更多