先判断要解析的是 Java 源码还是普通标签

如果项目只是为了查找某个词而引入完整语法树库，构建时间、依🎆赖管理和异常🎇处理都会变复杂。文本解析和源码解析应分成两个模块，分别设计输入校验、错误提示和测试用例，避免一个模块承担互不相同的任务。

处理混合字符时应保留原文与规范化值

对于含有敏感类别的文本，规范化字段应限制访问范围。日志中可以记录哈希值、内部编号或脱敏后的标签，避免把完整敏感词写入公开日志、错误页面和分析报表。

涉及成人内容标签的搜索系统，应把合法授权、年龄限制、隐私保护和内容审核放在技术实现之前。技术人员可以处理经过授权的分类字段、内部数据和脱🎉敏样本，但不应协助绕过访问限制、批量收集未授权内容或建立面向🎨未成年人的敏感内容推荐。

不适合用 JavaParser 的三种情况

混合标签文本的✅处理重点是字符统一，而不是盲目删除特殊符号。全角字符、半角字符、乘号、字母 x、字母 X 以及日文分隔符可能在视觉上接近，但在程序比较时并不相同。

JavaParser 解析含有目标词的 Java 源码时，应从抽象语法树节点入🔥手，而不是用简单字符串截取源码。一个字符串可能位于变量初始化、注解参数、方法调用、条件判🎊断或资源配置中，不同位置对应不同节点类型。