Oniguruma正则分组捕获function实现VSCode语法高亮匹配失败问题

问题原因及解决方案 #

1. 核心错误：捕获组顺序颠倒 #

你当前使用的正则：

(?>::\s*\b(function)\b)|\b(function)\b

的捕获组逻辑和你的需求完全相反：

• 前面带::的function会被第一个分支捕获，进入分组1
• 前面不带::的function会被第二个分支捕获，进入分组2
  和你要求的「无::进分组1、有::进分组2」的规则完全颠倒，这是高亮不生效的最常见原因。

2. 隐藏问题：存在重复匹配风险 #

regex101测试时默认按最长匹配优先，不会重复提取同一位置的子串，所以你的写法可以得到预期结果。但VSCode的TextMate语法高亮引擎会扫描所有可能的匹配位置，你当前的写法中，::后面的function除了会被第一个分支匹配之外，还可能被引擎从function的起始位置单独匹配第二个分支，导致规则冲突，结果不符合预期。

最终修正方案 #

修正后的正则

(?<!::\s{0,100})\b(function)\b|(?:\s*::\s*\b(function)\b)

规则说明：

• 第一个分支通过负向回溯断言(?<!::\s{0,100})确保匹配到的function前面100个字符内不存在::，捕获进入分组1，符合你对$1的匹配要求
• 第二个分支匹配前面带::（允许前后存在空格）的function，捕获进入分组2，符合你对$2的匹配要求
• 100个空格的长度限制是为了兼容Oniguruma可变长度回溯的要求，完全覆盖常规代码场景

VSCode语法配置注意事项

在JSON格式的tmLanguage配置中，需要对正则的反斜杠做转义，同时正确配置捕获组对应的作用域，示例如下：

{
  "match": "(?<!::\\s{0,100})\\b(function)\\b|(?:\\s*::\\s*\\b(function)\\b)",
  "captures": {
    "1": {
      "name": "keyword.control.function.YourLang"
    },
    "2": {
      "name": "variable.parameter.YourLang"
    }
  }
}

将YourLang替换为你定义的语言标识即可。

内容的提问来源于stack exchange，提问作者gnikit