JavaParser无法移除package声明前的注释：是Bug还是用法问题？

这不是JavaParser的Bug，而是你的代码漏掉了一类注释的处理——直接关联在CompilationUnit本身的注释。

问题根源 #

你当前的代码只调用了node.getAllContainedComments()，这个方法会递归遍历节点的所有子节点，获取那些嵌套在子节点内部的注释，但不会包含直接附加在CompilationUnit本身上的注释。而文件开头、package声明之前的注释，正是直接关联在CompilationUnit节点上的，不属于任何子节点的包含内容，所以你的代码没处理到它们。

你提到的“文件开头是行注释时，package前的块注释会被移除但行注释不会”也能印证这点：此时块注释可能关联在PackageDeclaration节点上（属于CompilationUnit的子节点），所以被getAllContainedComments()捕获到了；而开头的行注释直接属于CompilationUnit，因此没被移除。

修正方案 #

修改你的removeComments方法，在处理子节点包含的注释之前，先移除节点自身关联的所有注释（通过node.getComments()获取）：

static void removeComments(Node node) {
    // 移除当前节点直接关联的注释（比如CompilationUnit开头的注释）
    node.getComments().forEach(Comment::remove);
    // 移除所有子节点中包含的注释
    for (Comment child : node.getAllContainedComments()) {
        child.remove();
    }
}

验证效果 #

用你提供的测试代码，经过修正后的方法处理后，所有注释（包括文件开头的块注释、行注释，以及代码中的各类注释）都会被正确移除，最终结果会是：

package test;
public class Test {
    public static void main(String[] args) {
        System.out.println("print 1");
        System.out.println("print 2");
    }
}

额外说明 #

如果需要更彻底的递归处理（比如处理所有层级节点的自身注释），可以把方法改成递归形式，确保每个节点的自身注释都被处理：

static void removeComments(Node node) {
    // 移除当前节点的直接注释
    node.getComments().forEach(Comment::remove);
    // 递归处理所有子节点
    node.getChildNodes().forEach(YourClass::removeComments);
}

这种方式更通用，能覆盖所有场景下的注释移除，包括嵌套节点的自身关联注释。

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