VSCode插件需基于AST解析而非纯文本补全来精准生成代码，如toString()需识别字段修饰符、注解、类型及访问权限，并结合LSP获取元数据、配置化字段过滤、健壮模板（如Objects.toString）和生成后编译校验。
VSCode插件怎么让生成的代码不“瞎写”？
靠纯文本补全或模糊匹配生成的代码，大概率会漏字段、错类型、绕过项目约定。真正精准的自动化生成，必须基于 AST（抽象语法树）解析当前上下文，而不是只看光标附近几行字。
例如生成 toString() 时，插件得准确识别：private final List<string> tags;</string> 是字段而非局部变量，transient 修饰的字段默认不该参与输出，@JsonIgnore 注解的字段要主动跳过——这些都依赖对 Java 语法结构的深度理解，不是正则能搞定的。
- Language Support for Java™ 插件提供
textDocument/prepareCallHierarchy和textDocument/documentSymbol等 LSP 方法，可获取字段名、类型、修饰符、注解等元数据 - 直接读取
.java文件内容做字符串扫描，会误判匿名内部类里的同名变量、注释里的伪代码、甚至字符串字面量中的字段名 - 本地模型（如 CodeLlama-13B）若只跑在 prompt 工程层面，没接入 AST，生成结果就缺乏语义约束，容易写出
return "User{" + name + ", " + age + "}"这种缺引号、类型不安全的代码
字段筛选逻辑怎么和项目规范对齐？
生成 toString() 时，“全选字段”看似省事，实则埋雷：日志里打出来一堆敏感字段（如 passwordHash）、序列化字段（如 serialVersionUID）、或框架专用字段（如 hibernateLazyInitializer），轻则泄露信息，重则触发 NPE。
靠谱的做法是把筛选规则下沉到配置层，而不是靠人工勾选：
- 在
settings.json中声明排除规则："java.suggest.toString.excludeFields": ["password.*", "token", "serialVersionUID"] - 支持注解驱动过滤：识别
@ToString.Exclude（Lombok）、@Transient（JPA）、@JsonIgnore（Jackson）等标记并自动跳过 - 字段顺序按源码声明顺序保留，而非字母序——这对调试时快速定位关键字段很重要，但多数插件默认按字母排序，需显式关闭
sortFieldsAlphabetically
模板引擎里哪些细节决定生成质量？
一个 toString() 模板看着只是字符串拼接，但实际影响日志可解析性、IDE 调试体验、甚至单元测试稳定性。
比如这个常见错误：return "User{" + name + ", " + age + "}" ——当 name 为 null 时，输出变成 User{null, 30}，而更健壮的写法应调用 Objects.toString(name)。
- 推荐模板中直接嵌入标准工具方法：
Objects.toString($field$)替代裸引用，避免 NPE - 字段值包裹单引号（
'$field$'）仅适用于字符串类型；数字、布尔、枚举应不加引号，否则日志分析脚本会误判类型 - 启用
useToStringBuilder选项后，生成代码会依赖org.apache.commons.lang3.builder.ToStringBuilder，但需确保项目已引入对应依赖，否则编译失败
为什么本地模型生成的 toString 还是不对？
即使你配置了 codellama-13b.q5.gguf 并启用本地推理，生成结果仍可能偏离预期——问题往往不在模型本身，而在提示词（prompt）没绑定上下文约束。
典型表现：模型知道 Java 语法，但不知道你项目里 User 类的 email 字段其实是 Optional<String>，于是生成 "email='"+ email +'"'，而正确写法应是 "email="+ email.map(e -> "'" + e + "'").orElse("null")。
- VSCode 插件必须把 AST 解析出的字段类型（包括泛型擦除后的真实类型）注入 prompt，不能只传字段名列表
- 禁用模型“自由发挥”：在 system prompt 中明确限定“只输出 Java 代码，不解释，不添加注释，不修改字段访问方式”
- 生成后强制校验：用
javac -C编译生成片段，捕获error: cannot find symbol类错误并回退到 AST 安全模式
最易被忽略的是字段访问权限——插件生成的 toString() 默认用 this.name，但如果字段是 protected 或包私有，且类在不同包中被继承，这个引用就失效了。真正鲁棒的实现，得根据目标类的实际可见性决定用 getName() 还是直接字段访问。
