如何禁用VSCode生成Java代码时自动添加的Checker Framework注解？

问题背景 #

在VSCode开发Java项目时，使用代码生成功能（比如实现未实现方法、提取变量）会自动添加UnknownKeyFor、NonNull、Initialized这类注解。这类注解来自Checker Framework，且仅在使用Apache Beam 2.28.0及更高版本时出现——Beam从该版本开始引入了Checker Framework的依赖，导致VSCode的代码生成工具自动拾取并插入这些注解。

解决方案 #

方案1：调整VSCode Java插件设置 #

直接禁用代码生成时的注解自动添加功能：

• 打开VSCode设置（快捷键Ctrl+,）
• 搜索java.codeGeneration.generateAnnotations，将其设置为false
• 或者精准关闭空值分析相关注解，搜索java.completion.nullAnalysis.mode，设置为disabled

也可以直接在settings.json中添加配置：

{
    "java.codeGeneration.generateAnnotations": false,
    "java.completion.nullAnalysis.mode": "disabled"
}

方案2：从项目依赖中排除Checker Framework #

如果不需要Checker Framework的注解支持，可以在依赖管理中排除相关包：

• Maven：在Beam依赖中添加排除规则

<dependency>
    <groupId>org.apache.beam</groupId>
    <artifactId>beam-sdks-java-core</artifactId>
    <version>你的Beam版本</version>
    <exclusions>
        <exclusion>
            <groupId>org.checkerframework</groupId>
            <artifactId>checker-qual</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle：在依赖声明中加入排除配置

implementation('org.apache.beam:beam-sdks-java-core:你的Beam版本') {
    exclude group: 'org.checkerframework', module: 'checker-qual'
}

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