此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
String.prototype.substring()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
String 的substring() 方法返回该字符串从起始索引到结束索引（不包括）的部分，如果未提供结束索引，则返回到字符串末尾的部分。
尝试一下
const str = "Mozilla";console.log(str.substring(1, 3));// Expected output: "oz"console.log(str.substring(2));// Expected output: "zilla"语法
substring(indexStart)substring(indexStart, indexEnd)参数
indexStart返回子字符串中第一个要包含的字符的索引。
indexEnd可选返回子字符串中第一个要排除的字符的索引。
返回值
包含给定字符串的指定部分的新字符串。
描述
substring() 方法从indexStart 开始提取字符，直到（但不包括）indexEnd。具体来说：
- 如果省略了
indexEnd，则substring()提取字符直到字符串的末尾。 - 如果
indexStart等于indexEnd，则substring()返回一个空字符串。 - 如果
indexStart大于indexEnd，则substring()的效果就像交换了这两个参数一样；请参考下面的示例。
任何小于0 或大于str.length 的参数值都会被视为分别等于0 和str.length。
任何值为NaN 的参数将被视为等于0。
示例
使用 substring()
下例使用substring 输出字符串"Mozilla" 中的字符：
const anyString = "Mozilla";console.log(anyString.substring(0, 1)); // 'M'console.log(anyString.substring(1, 0)); // 'M'console.log(anyString.substring(0, 6)); // 'Mozill'console.log(anyString.substring(4)); // 'lla'console.log(anyString.substring(4, 7)); // 'lla'console.log(anyString.substring(7, 4)); // 'lla'console.log(anyString.substring(0, 7)); // 'Mozilla'console.log(anyString.substring(0, 10)); // 'Mozilla'调用 substring() 时使用 length 属性
以下示例使用substring() 方法和length 属性来提取特定字符串的最后字符。这种方法可能更容易记住，因为你不需要像上面的示例那样知道起始和结束索引。
const text = "Mozilla";// 获取字符串的最后 4 个字符console.log(text.substring(text.length - 4)); // 打印“illa”// 获取字符串的最后 5 个字符console.log(text.substring(text.length - 5)); // 打印“zilla”substring() 和 substr() 之间的区别
substring() 和substr() 方法之间存在细微差别，因此你应该小心不要混淆它们。
substr()方法的两个参数是start和length，而substring()方法的参数是start和end。- 如果
substr()的start索引为负数，它将循环到字符串的末尾，而substring()会将其限制为0。 - 在
substr()中，如果长度为负数，将被视为零；而在substring()中，如果end小于start，则会交换这两个索引。
此外，substr() 被认为是 ECMAScript 中的遗留特性，因此如果可能的话最好避免使用它。
const text = "Mozilla";console.log(text.substring(2, 5)); // "zil"console.log(text.substr(2, 3)); // "zil"substring() 和 slice() 之间的区别
substring() 和slice() 方法几乎相同，但在处理负数参数时有一些细微差别。
substring() 方法在indexStart 大于indexEnd 的情况下会交换它的两个参数，这意味着仍会返回一个字符串。而slice() 方法在这种情况下返回一个空字符串。
const text = "Mozilla";console.log(text.substring(5, 2)); // "zil"console.log(text.slice(5, 2)); // ""如果两个参数中的任何一个或两个都是负数或NaN，substring() 方法将把它们视为0。
console.log(text.substring(-5, 2)); // "Mo"console.log(text.substring(-5, -2)); // ""slice() 方法也将NaN 参数视为0，但当给定负值时，它会从字符串的末尾开始反向计数以找到索引。
console.log(text.slice(-5, 2)); // ""console.log(text.slice(-5, -2)); // "zil"请参阅slice() 页面以获取更多关于负数的示例。
替换字符串中的子字符串
以下示例替换字符串中的子字符串。它可以替换单个字符和子字符串。示例的最后一个函数调用将字符串Brave New World 更改为Brave New Web。
// 将字符串 fullS 中的 oldS 替换为 newSfunction replaceString(oldS, newS, fullS) { for (let i = 0; i < fullS.length; ++i) { if (fullS.substring(i, i + oldS.length) === oldS) { fullS = fullS.substring(0, i) + newS + fullS.substring(i + oldS.length, fullS.length); } } return fullS;}replaceString("World", "Web", "Brave New World");请注意，如果oldS 本身是newS 的子字符串，这可能导致无限循环，例如，假如你尝试在此处用"OtherWorld" 替换"World"。
替换字符串的更好方法如下：
function replaceString(oldS, newS, fullS) { return fullS.split(oldS).join(newS);}上面的代码仅作为子字符串操作的示例。如果你需要替换子字符串，大多数情况下你会想要使用String.prototype.replace() 函数。
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.substring |