三大截取方法簽名對比
| 方法 | 參數含義 | 負數處理 | 標準狀態 | 推薦度 |
slice(start, end?) | 起始索引、結束索引(不含) | 負數 = length + 負數 (從末尾計算) | ES3 標準 | ⭐⭐⭐ 首選 |
substring(start, end?) | 起始索引、結束索引(不含) | 負數視為 0;start > end 自動交換 | ES3 標準 | ⭐⭐ 兼容舊代碼 |
substr(start, length?) | 起始索引、長度 | start 負數 = length + 負數;length 負數視為 0 | ES3 附錄 B (非標準,瀏覽器兼容) | ⭐ 不推薦新代碼 |
核心差異演示
var str = '歡迎各位童鞋到腳本之家做客'; // 長度 14
// 1. 正常範圍:結果相同
str.slice(3, 11); // "位童鞋到腳本之家"
str.substring(3, 11); // "位童鞋到腳本之家"
str.substr(3, 8); // "位童鞋到腳本之家" (長度 8)
// 2. 負數索引:slice 輸贏
str.slice(-6); // "腳本之家做客" (最後 6 個字符)
str.substring(-6); // "歡迎各位童鞋到腳本之家做客" (負數當 0,返回整串)
str.substr(-6); // "腳本之家做客" (同 slice)
// 3. start > end:substring 獨特
str.substring(11, 3); // "位童鞋到腳本之家" (自動交換)
str.slice(11, 3); // "" (空字符串)
str.substr(11, 3); // "做客" (從 11 取 3 長度)
// 4. 參數越界:都會自動鉗制到 [0, length]
str.slice(100); // ""
str.substring(100); // ""
str.substr(100); // ""
Unicode 陷阱:代理對 (Surrogate Pairs) 與 Emoji
var emoji = '😀🎉👍'; // 每個 Emoji = 2 個代碼單元 (UTF-16)
console.log(emoji.length); // 6 (非 3!)
// 截取第一個 Emoji
emoji.slice(0, 1); // "\uD83D" (高代理項,單獨顯示為亂碼 )
emoji.slice(0, 2); // "😀" (正確)
emoji.substring(0, 2); // "😀"
emoji.substr(0, 2); // "😀"
// 正確按「視覺字符」截取:使用 Array.from / 展開運算符 / 正則
var chars = [...emoji]; // ["😀", "🎉", "👍"]
chars.slice(0, 1).join(''); // "😀"
// 或用正則匹配 Grapheme Cluster (ES2018+)
var graphemes = emoji.match(/\P{M}+|\p{M}/gu); // 需支持 Unicode 屬性類
// 更簡單:Array.from / [...str] 已按 Unicode 代碼點分割
實戰封裝:安全的截取工具函數
var StrUtil = {
/**
* 按字符長度截取 (支持 Emoji、組合字符)
* @param {string} str
* @param {number} maxLen 最大字符數
* @param {string} suffix 超長後綴,默認 '...'
* @returns {string}
*/
truncate: function (str, maxLen, suffix) {
if (typeof str !== 'string') str = String(str);
if (maxLen <= 0) return '';
suffix = suffix || '...';
// 按 Unicode 代碼點分割
var chars = [...str];
if (chars.length <= maxLen) return str;
return chars.slice(0, maxLen).join('') + suffix;
},
/**
* 按字節長度截取 (GBK/UTF-8),配合後端字段限制
*/
truncateByBytes: function (str, maxBytes, charset, suffix) {
if (typeof str !== 'string') str = String(str);
if (maxBytes <= 0) return '';
suffix = suffix || '...';
var suffixBytes = getByteLength(suffix, charset);
var available = maxBytes - suffixBytes;
if (available <= 0) return suffix;
var len = 0;
var chars = [...str]; // 按字符遍歷
for (var i = 0; i < chars.length; i++) {
var charBytes = getByteLength(chars[i], charset);
if (len + charBytes > available) break;
len += charBytes;
}
return chars.slice(0, i).join('') + suffix;
},
/**
* 獲取字符串視覺字符數 (非代碼單元數)
*/
getVisualLength: function (str) {
return [...String(str)].length;
}
};
// 輔助:字節長度計算 (見上文 getByteLength)
function getByteLength(str, charset) { /* ... */ }
常見場景最佳實踐
| 場景 | 推薦方法 | 理由 |
| 簡單截取前 N 個字符 | str.slice(0, n) | 語義清晰、負數支持、標準化 |
| 從末尾取最後 N 個字符 | str.slice(-n) | 負數索引直觀 |
| 去除首尾空白後截取 | str.trim().slice(0, n) | 鏈式調用 |
| 含 Emoji 的安全截取 | [...str].slice(0, n).join('') | 避免切斷代理對 |
| 按字節長度截取 (入庫) | 自定義 truncateByBytes | 匹配數據庫字段定義 |
| 獲取文件擴展名 | filename.slice(filename.lastIndexOf('.') + 1) | 配合 lastIndexOf |
避坑清單
- ❌ 不用
substr:非標準、參數語義異、TypeScript 類型定義中已標記棄用
- ❌ 不用
substring 處理負數:負數被當 0,易導致邏輯錯誤
- ❌ 別用
str.length 判斷「字符數」:Emoji 算 2,[...str].length 才準確
- ✅ 統一用
slice:參數語義統一(起止索引)、負數語義一致、支持數組、標準化
- ✅ 需要「視覺字符」長度時:用
[...str] 或 Array.from(str) 轉數組
總結
JavaScript 三大截取方法中,**slice 是唯一推薦用於新代碼的標準方法**:參數語義統一(起止索引)、負數支持直觀、適用于字符串/數組、ES3 起標準化。substring 僅用於維護舊代碼;substr 已棄用。處理 Emoji 等補充平面字符時,必須用 [...str] 按 Unicode 代碼點分割,而非依賴 UTF-16 代碼單元索引。