萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 字符串截取:substring vs substr vs slice 完整對比指南

三大截取方法簽名對比

方法參數含義負數處理標準狀態推薦度
slice(start, end?)起始索引、結束索引(不含)負數 = length + 負數 (從末尾計算)ES3 標準⭐⭐⭐ 首選
substring(start, end?)起始索引、結束索引(不含)負數視為 0;start > end 自動交換ES3 標準⭐⭐ 兼容舊代碼
substr(start, length?)起始索引、長度start 負數 = length + 負數;length 負數視為 0ES3 附錄 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 代碼單元索引。

copyright © 萬盛學電腦網 all rights reserved