JS字符串内置方法substring与substr的用法区别
详细解析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 个字符并返回,不需要开发者手动计算结束位置的下标。
下面通过一段可在浏览器控制台(按 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 个字符,直接返回空字符串 ""。
这种“负数变 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 核心标准方法。
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 安全替换为标准方法:
- 只传了一个非负参数
str.substr(start):直接将方法名替换为str.substring(start)或str.slice(start),行为完全一致。 - 传了起始位置与固定长度
str.substr(start, len)(且start >= 0,len >= 0):将第二个参数从“长度”改写为“起始位置 + 长度”,即替换为str.substring(start, start + len)。 - 第一个参数使用了负数倒数
str.substr(-n):直接替换为str.slice(-n)。 - 第一个参数为负数且同时指定了截取长度
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 遗留特性(已弃用,不推荐新写) | 核心标准方法(推荐使用) |
总结来说,阅读旧代码时只需记住 substring 第二个参数是结束下标、substr 第二个参数是截取字符个数;而在编写新代码时,如果明确使用非负索引区间,使用 substring(start, end) 即可;如果需要利用负数从字符串末尾倒数截取,则应统一使用 slice,不再新增 substr 调用。
推荐5款免费开源的JS表格插件,避免商业授权陷阱
2026-11-18 18:32:34
原生JS使用Fetch和FormData实现图片上传
2026-11-18 17:54:48
JS子类怎么继承和重写父类静态方法
2026-11-18 16:03:05
JS判断闰年的基础代码实现与规则解析
2026-11-18 15:47:30
JS字符串排序怎么处理null和undefined空值?
2026-11-18 15:44:58








