萬盛學電腦網

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

JavaScript 正則驗證「純中文」:正確寫法與常見誤區

表單驗證中「判斷輸入是否為純中文」看似簡單,實則暗藏 Unicode 範圍、字符集編碼、輸入法組合字符等坑。本文給出嚴謹的正則寫法、邊界測試用例與工程化封裝建議。

核心正則

// 僅匹配 CJK 統一表意文字(基本區 + 擴展 A)
const RE_HANZI_ONLY = /^[\u4e00-\u9fa5]+$/;
// 或使用 Unicode 屬性逃逸(ES2018+,需 u 標誌)
const RE_HANZI_UNICODE = /^\p{Script=Han}+$/u;

常見錯誤寫法對比

寫法問題測試結果
/^[\u4E00-\u9FA5]+$/大小寫不敏感下 \u9FA5 正確,但漏掉擴展區通過「漢字」,漏「𠮷」(U+20BB7)
/^[\u4e00-\u9fff]+$/擴大到 \u9fff,覆蓋基本區全部通過基本區,仍漏擴展 A/B
/^[\u3400-\u9fff]+$/包含擴展 A(\u3400-\u4dbf)覆蓋 99% 常用漢字,仍漏擴展 B-F
/^[\u2E80-\u9FFF]+$/包含康熙部首、注音符號等非漢字會誤判「ㄱㄴㄷ」為中文
/^[\p{Han}]+$/uUnicode 標準屬性,最精準✅ 覆蓋所有漢字,排除假名/諺文

完整驗證函數(含單元測試)

/**
 * 判斷字符串是否僅包含漢字
 * @param {string} str
 * @param {Object} opts
 *   - allowSpace: boolean  是否允許空格(默認 false)
 *   - allowPunct: boolean  是否允許中文標點(默認 false)
 * @returns {boolean}
 */
function isChineseOnly(str, {allowSpace = false, allowPunct = false} = {}) {
  if (typeof str !== 'string') return false;
  if (!str) return false; // 空串視為不通過,視業務而定

  let pattern = '\\p{Script=Han}';
  if (allowSpace) pattern += '\\s';
  if (allowPunct) pattern += '\\p{Punct}'; // 含中英文標點,如需僅中文標點可自定義集合
  const re = new RegExp(`^${pattern}+$`, 'u');
  return re.test(str);
}

// 單元測試
const cases = [
  ['中文', true],
  ['中文123', false],
  ['Chinese', false],
  ['中文 English', false],
  ['中文、英文', false], // 標點不通過
  ['', false],
  ['𠮷野家', true], // 擴展 B 字符
  ['😀', false], // Emoji
  ['ㄱㄴㄷ', false], // 韓文諺文
  ['あいう', false], // 日文假名
];

cases.forEach(([input, expected]) => {
  const res = isChineseOnly(input);
  console.log(`${res === expected ? '✅' : '❌'} "${input}" => ${res} (期望 ${expected})`);
});

// 允許空格版本
console.log(isChineseOnly('中文 名', {allowSpace: true})); // true

工程化建議

  1. 統一封裝到 utils/validate.js,導出 isChineseOnly、isEmail、isPhone 等,避免分散在各業務文件。
  2. 配合 HTML5 原生驗證:<input pattern="[\p{Script=Han}]+" title="請輸入純中文">(需瀏覽器支持 pattern 的 Unicode 模式)。
  3. 輸入法組合字符處理:在 compositionend 事件後再驗證,避免拼音輸入中間態觸發誤報。
  4. 服務端二次驗證:前端驗證只為 UX,後端必須再次正則校驗,防止繞過前端。

擴展:提取字符串中的中文片段

function extractChinese(str) {
  return str.match(/[\p{Script=Han}]+/gu)?.join('') || '';
}
console.log(extractChinese('姓名:张三,Age: 25')); // "姓名张三"

總結

  • 現代項目**首選 /^\p{Script=Han}+$/u**,精準覆蓋所有 Unicode 漢字。
  • 舊環境(不支持 u 標誌)可用 /^[\u3400-\u9fff]+$/ 覆蓋 99% 場景。
  • 業務常需「允許空格/標點」,通過參數動態構建正則更靈活。
  • 前端驗證 ≠ 安全邊界,**後端必須再驗**。
copyright © 萬盛學電腦網 all rights reserved