Ключевые Изменения

Checkstyle 13.7.0, выпущенный 28 июня 2026 года, представляет несколько улучшений и критических исправлений ошибок, в основном сосредоточенных на обеспечении стиля кода и совместимости.

Новые Возможности:

  • Правила Стиля Кода: Новое свойство jdkVersion для UnusedLocalVariable позволяет специфическую обработку неиспользуемых именованных переменных сопоставления с образцом в коде до Java 22. OverloadMethodsDeclarationOrder получает свойство required для принудительного упорядочивания перегруженных методов по возрастающему количеству параметров.
  • Улучшения Javadoc: MissingJavadocMethodCheck и JavadocMethod теперь используют Abstract Syntax Tree (AST) Javadoc, что приводит к более точному и надежному анализу Javadoc.

Исправления Ошибок:

  • Соответствие Стилю OpenJDK: Добавлено или исправлено множество проверок для соответствия различным разделам Руководства по стилю OpenJDK, включая константы, перенос выражений, модификаторы, структуру классов, операторы импорта, порядок конструкторов, имена классов, интерфейсов и перечислений, избыточные скобки и комментарии документации. Это значительно улучшает соблюдение стандартов OpenJDK.
  • Компактные Исходные Файлы JEP 512: Исправлен ряд ошибок, связанных с JEP 512 (Compact Source Files). Эти исправления устраняют ложные срабатывания и некорректное поведение в проверках, таких как UnnecessarySemicolonAfterTypeMemberDeclarationCheck, DeclarationOrderCheck, AnnotationLocationCheck, RequireThisCheck, InvalidJavadocPositionCheck и OuterTypeNumberCheck, обеспечивая правильный анализ компактных исходных файлов.
  • Парсинг Javadoc: Исправлены несколько ошибок парсинга Javadoc, особенно те, которые касались меток @link с инициализаторами массивов и форматированных тегов @value, что повышает надежность проверок Javadoc.

Полный список изменений доступен в официальных примечаниях к выпуску.

Влияние на QA-команды

QA-команды получают выгоду от более точного применения стиля кода, особенно для Java-проектов, следующих рекомендациям OpenJDK или использующих компактные исходные файлы JEP 512. Улучшенные проверки Javadoc уменьшают количество ложных срабатываний, оптимизируя процессы ревью кода и статического анализа. Это обновление помогает поддерживать более высокие стандарты качества кода.

FAQ

  • В: На чем сосредоточено основное внимание Checkstyle 13.7.0?
    • О: Обновление в основном направлено на улучшение соответствия стилю OpenJDK, оптимизацию анализа Javadoc и исправление проблем, связанных с компактными исходными файлами JEP 512.
  • В: Как это обновление влияет на проекты, использующие JEP 512?
    • О: Оно устраняет несколько ошибок, которые вызывали ложные срабатывания и некорректное поведение в компактных исходных файлах, обеспечивая более точный статический анализ для таких проектов.
  • В: Есть ли новые правила стиля кода в этом выпуске?
    • О: Да, новые свойства для UnusedLocalVariable и OverloadMethodsDeclarationOrder предлагают более детальный контроль над применением стиля кода.