方法簽名速查
| 方法 | 語法 | 參數含義 | 返回值 |
slice | str.slice(begin[, end]) | 開始索引(含)、結束索引(不含),**可負** | 新字符串 |
substring | str.substring(indexA[, indexB]) | 兩個索引,**自動交換大小**,負值視為 0 | 新字符串 |
substr | str.substr(start[, length]) | 開始索引、**長度**,start 可負(ES2016 標準化,IE8- 不支援) | 新字符串 |
核心差異示例
var str = 'abcdefghij';
// 1. 正常範圍
str.slice(1, 3) // 'bc'
str.substring(1, 3) // 'bc'
str.substr(1, 2) // 'bc'
// 2. 參數反轉
str.substring(3, 1) // 'bc' (自動交換)
str.slice(3, 1) // '' (空,start > end)
str.substr(3, -2) // '' (長度負視為 0)
// 3. 負數索引
str.slice(-3) // 'hij' (倒數 3 位)
str.slice(-3, -1) // 'hi' (倒數 3 到倒數 2)
str.substring(-3) // 'abcdefghij' (負視為 0)
str.substr(-3) // 'hij' (ES2016+,IE8- 視為 0 → 全字串)
str.substr(-3, 2) // 'hi'
// 4. 越界處理
str.slice(20) // ''
str.substring(20) // ''
str.substr(20, 2) // ''
str.substr(-20, 2) // 'ab' (IE8- 視為 substr(0,2) → 'ab')
關鍵行為差異總結
| 特性 | slice | substring | substr |
| 負數 start | ✅ 從末尾計算 | ❌ 視為 0 | ⚠️ ES2016 標準化,IE8- 視為 0 |
| 負數 end/length | ✅ end 從末尾計算 | ❌ 視為 0 | ❌ length 負視為 0 |
| 參數順序敏感 | ✅ start > end 返回空 | ❌ 自動交換 | ✅ length 為負返回空 |
| 語義 | 切片(類陣列通用) | 子串區間 | 子串長度(歷史遺留) |
| 標準狀態 | ECMAScript 核心 | ECMAScript 核心 | **附錄 B (規範性可選)**,不推薦新代碼使用 |
選型建議
- 首選
slice:語義清晰、支援負數、行為與陣列 slice 一致、無歷史包袱。
- 避免
substr:非核心標準、IE8- 負數行為不一、易混淆「長度」與「結束索引」。
substring 適用場景:需自動處理參數順序(如用戶輸入兩個位置構建範圍),但負數處理異常需注意。
實用片段
// 獲取最後 n 字符
function lastN(str, n) { return str.slice(-n); }
// 去除首尾各 n 字符
function trimN(str, n) { return str.slice(n, -n); }
// 截取指定字符之間內容
function between(str, startChar, endChar) {
var s = str.indexOf(startChar);
var e = str.indexOf(endChar, s + 1);
return s !== -1 && e !== -1 ? str.slice(s + 1, e) : '';
}
TypeScript 類型提示
// 所有方法簽名
declare interface String {
slice(beginIndex: number, endIndex?: number): string;
substring(indexStart: number, indexEnd?: number): string;
substr(start: number, length?: number): string; // 標註為 deprecated
}
現代代碼庫建議配置 ESLint 規則 no-restricted-properties: ["error", { "object": "String", "property": "substr" }] 禁止使用 substr,統一遷移至 slice。