ANTLR4投注线语法解析异常：数字未识别问题排查

数字无法识别的常见原因 #

• 词法规则优先级冲突：ANTLR4的词法规则遵循「最长匹配」+「先定义先匹配」原则。如果语法里有覆盖数字的规则（比如ID: [a-zA-Z0-9]+;）且定义在NUMBER规则之前，纯数字会被优先识别为ID而非NUMBER。
• 数字规则定义不全：如果投注文本里有带小数点的数字，但你的NUMBER规则只写了[0-9]+，带小数的部分会被拆分或匹配失败。
• 空白字符规则误吞数字：如果空白规则（比如WS）不小心包含了数字的字符范围，或处理逻辑错误，会导致数字被当成空白跳过。

line模式未在换行终止的常见原因 #

• line规则定义过于贪婪：比如写成line: .+;，.会匹配除换行外的所有字符，但+是贪婪匹配，会一直读到文件末尾而非换行处。正确写法应为line: ~[\r\n]+;（匹配所有非换行字符），或明确加上换行终止逻辑，比如line: ~[\r\n]+ (NEWLINE | EOF);。
• 换行符被跳过：如果词法规则里把换行符（比如NEWLINE: '\r'? '\n' -> skip;）设置为跳过，解析器无法感知换行存在，自然不会在换行处终止line模式。
• 规则上下文错误：如果line是某个父规则的子规则，父规则的逻辑可能强制line继续匹配后续内容，导致换行无法触发终止。

• ANTLR TestRig（grun命令）：ANTLR自带的调试工具，能直接输出token流和语法树。比如执行grun YourGrammarName tokens -tokens test_input.txt，可查看每个字符对应的token类型，快速发现数字的识别异常、换行符的处理情况；若要查看语法树，用grun YourGrammarName startRule -gui test_input.txt，可视化观察line规则的匹配范围。
• ANTLRWorks 2：可视化语法开发工具，支持实时编辑语法、测试输入文本，能直观看到token拆分、语法树构建的每一步，还可设置断点调试解析过程，快速定位规则冲突点。
• 自定义token打印代码：在测试代码里遍历词法分析器生成的Token对象，打印每个token的getType()和getText()，直接验证数字对应的token类型是否符合预期，以及换行符是否被正确识别或跳过。

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