表單驗證中「判斷輸入是否為純中文」看似簡單,實則暗藏 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}]+$/u | Unicode 標準屬性,最精準 | ✅ 覆蓋所有漢字,排除假名/諺文 |
/**
* 判斷字符串是否僅包含漢字
* @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
isChineseOnly、isEmail、isPhone 等,避免分散在各業務文件。<input pattern="[\p{Script=Han}]+" title="請輸入純中文">(需瀏覽器支持 pattern 的 Unicode 模式)。compositionend 事件後再驗證,避免拼音輸入中間態觸發誤報。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% 場景。