← All recipes
Moderne licensed

Remove unused local variables

Recipe IDorg.openrewrite.staticanalysis.RemoveUnusedLocalVariables
Artifactorg.openrewrite.recipe:rewrite-static-analysis

If a local variable is declared but not used, it is dead code and should be removed. Unused variables increase cognitive load for readers who must determine whether the variable matters, and they may signal incomplete implementations or missed refactoring.

Single recipeRSPEC-S1481MSAL

Usage

This recipe has no required configuration options. You’ll need the Moderne CLI configured before running the command below.

mod run . --recipe org.openrewrite.staticanalysis.RemoveUnusedLocalVariables

If the recipe isn’t available locally, install it with:

mod config recipes jar install org.openrewrite.recipe:rewrite-static-analysis:2.40.0

Options

NameTypeDescription
ignoreVariablesNamedString[]An array of variable identifier names for local variables to ignore, even if the local variable is unused.
e.g. [unused, notUsed, IGNORE_ME]
withTypeStringA fully qualified class name. Only unused local variables whose type matches this will be removed. If empty or not set, all unused local variables are considered for removal.
e.g. java.lang.String
withSideEffectsBooleanWhether to remove unused local variables despite side effects in the initializer. Default false.

Data tables

Structured output this recipe can produce.

  • Source files that had resultsSource files that were modified by the recipe run.org.openrewrite.table.SourcesFileResults
  • Source files that had search resultsSearch results that were found during the recipe run.org.openrewrite.table.SearchResults
  • Source files that errored on a recipeThe details of all errors produced by a recipe run.org.openrewrite.table.SourcesFileErrors
  • Recipe performanceStatistics used in analyzing the performance of recipes.org.openrewrite.table.RecipeRunStats