В Eclipse есть параметр компилятора Java, который называется «объявление поля скрывает другое поле или переменную», для которого можно задать предупреждение / ошибка.

Насколько важно это предупреждение по вашему мнению?

Что является хорошим стандартным способом решения этой проблемы?

Пример кода, где это происходит:

public class Test {
   private String caption = null;

   public Test(String caption) { // here
     this.caption = caption;
   }
}

Я видел решения, в которых поле переименовывалось, то есть "fCaption", но это приводило бы к тому, что автоматические методы получения / установки, которые могут быть созданы, имели нечетные имена (getfCaption()). Не нечитабельно, но безобразно ...

Редактировать: О да, есть возможность переименовать подпись методаTest(String caption_) или что-то подобное, но это в конечном итоге в Javadoc выглядит странно.