JavaScript RegExp.escape：输入只是一个文件名，句点为什么变成了匹配规则
给一组名称增加搜索框时，直接写 new RegExp(query) 看起来很方便。输入 a.b 后，axb 和 a-b 也可能被选中，因为句点已经作为正则语法参与匹配。若用户输入的是要查找的文字，应在构造模式以前明确把它转换成字面片段。
RegExp.escape 就用于这个转换。它返回的是可以嵌入模式的字符串，不会直接执行搜索，也不替你决定大小写或整段匹配范围。下例先比较同一份名称清单，再演示一个更不显眼的问题：把数字接在反向引用之后，可能改变前面的转义含义。
本文使用 Node.js v24.19.0，已实际确认 RegExp.escape 存在。旧环境应先检查 typeof RegExp.escape，不能只因为 RegExp 构造器可用就认为新方法也可用。将完整代码保存为 demo.mjs，运行 node demo.mjs；仅处理固定内存字符串。
AI模型生成概念插图：带特殊符号的片段以完整内容进入搜索区域，表示保留字面含义；图中符号用于说明概念，不是正则运行界面。
完整实验程序
import assert from 'node:assert/strict';
assert.equal(typeof RegExp.escape, 'function');
const names = ['a.b', 'axb', 'a-b', 'ab'];
const query = 'a.b';
const loose = new RegExp(query, 'u');
const literal = new RegExp(RegExp.escape(query), 'u');
const looseHits = names.filter(name => loose.test(name));
const literalHits = names.filter(name => literal.test(name));
assert.deepEqual(looseHits, ['a.b', 'axb', 'a-b']);
assert.deepEqual(literalHits, ['a.b']);
console.log('raw', JSON.stringify(looseHits));
console.log('escaped', JSON.stringify(literalHits));
console.log('fragment', RegExp.escape('a-b'));
const digit = '2';
const combined = new RegExp('(a)\\1' + RegExp.escape(digit), 'u');
assert.equal(combined.test('aa2'), true);
console.log('after backreference', combined.source, combined.test('aa2'));
assert.throws(() => new RegExp('(a)\\1' + digit, 'u'), SyntaxError);
console.log('raw appended digit', 'SyntaxError');
assert.throws(() => RegExp.escape(23), TypeError);
console.log('non-string', 'TypeError');本地实际输出
raw ["a.b","axb","a-b"] escaped ["a.b"] fragment \x61\x2db after backreference (a)\1\x32 true raw appended digit SyntaxError non-string TypeError
先看搜索集合有没有扩大
raw 一行选中 a.b、axb、a-b 三项，因为模式中的句点可以匹配中间的普通字符。escaped 一行只留下 a.b。输入清单没有变化，变化发生在构造模式时，因此修复应放在文本进入正则语法的边界。
fragment 输出中，a 被写成十六进制转义，连字符也有相应转义。这种结果看起来不如原文字直观，但目标是让片段在模式中保持含义，不能为了让日志好看就删掉这些反斜杠。显示给用户时可以保留原查询，执行搜索时使用转换后的片段。
例子使用无 g 标志的模式逐项 test，避免多次测试共享搜索位置。这里验证的是包含该字面片段的搜索；如果需求只是完全相等或简单包含，直接用字符串比较或 includes 往往更清楚，不必先引入正则。
开头的数字也可能需要保护
combined 的源模式是一个捕获组、指向第一组的反向引用，再接被保护的数字二。它可以匹配 aa2。若把原始数字直接拼上去，在本例的 u 模式里会形成另一段无效引用，程序明确捕获 SyntaxError。只替换句点、星号等显眼字符的手写函数，容易漏掉这种拼接边界。
最后一条 TypeError 说明 RegExp.escape 要求字符串输入，并不会在这里替调用者决定怎样解释数字二十三。真实搜索入口可先做业务类型校验；若接口明确允许数字，再有意使用 String 转成文字，而不是把任意对象默默交给隐式转换。
转义不能替代完整的输入策略。空字符串会构造能在很多位置匹配的空片段；是否允许空搜索，需要在界面或业务层决定。大小写、Unicode规范化以及是否需要词边界，也各有独立规则。先约定想找到什么，再把只应当作文字的部分交给 RegExp.escape。
参考资料
官方资料核验日期：2026-10-02。以上输出来自文中完整程序，断言通过，退出状态为零。
