VS Code 1.80.0新文件选择代码片段失效及Java扩展异常排查

问题现象 #

在VS Code 1.80.0中创建新Java文件时，选择型代码片段（choice-type snippet suggestions）无法正常触发，Red Hat Java扩展1.20.0的代码片段及其他代码提示均未按预期显示。Java输出日志报错如下：

!ENTRY org.eclipse.jdt.ls.core 4 0 2023-07-11 19:09:12.705
!MESSAGE Error occured while building workspace. Details: 
 message: Syntax error, insert ";" to complete BlockStatements; code: 1610612976; resource: <path>.java; line: 6
 message: sout cannot be resolved; code: 570425394; resource: <path>.java; line: 6
 message: Syntax error, insert "VariableDeclarators" to complete LocalVariableDeclaration; code: 1610612976; resource: <path>.java; line: 6

成因分析 #

1. 语法上下文非法：新建Java文件默认无完整类/方法结构，代码片段（如sout）插入后处于类的直接作用域而非方法内部，违反Java语法规范，触发JDT-LS（Java语言服务）的语法错误，阻塞后续代码提示服务。
2. 版本兼容性冲突：VS Code 1.80.0对代码片段的触发逻辑或上下文解析机制做了变更，Red Hat Java 1.20.0未适配该变更，导致选择型代码片段的上下文校验失败。
3. JDT-LS实时校验阻塞：JDT-LS的实时语法校验在检测到严重语法错误时，会暂停代码提示等辅助功能，导致代码片段无法正常展示。

解决方法 #

• 版本调整：
  • 降级VS Code至1.79.x版本，避开1.80.0的代码片段逻辑问题；
  • 升级Red Hat Java扩展至1.21.x及以上版本，官方通常会修复与新版VS Code的兼容性问题。
• 规范代码上下文：新建Java文件后，先手动生成完整的类和方法结构（如输入class补全类框架，再添加main方法），再在方法内部使用代码片段。
• 临时调整校验设置：关闭JDT-LS的实时语法校验（不推荐长期使用）：在VS Code设置中搜索java.validation.enabled，将其设置为false，但此操作会关闭所有Java语法校验功能。
• 重置配置：删除工作区.vscode/settings.json中的Java自定义配置，或重置VS Code全局Java配置，恢复默认设置后重试。

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