Eclipse tiene una configuración de compilador de Java llamada "declaración de campo oculta otro campo o variable" que se puede establecer en advertencia / error.

¿Qué tan importante es esta advertencia en tu opinión?

¿Cuál es una buena forma estándar de manejar este problema?

Ejemplo de código de dónde sucede esto:

public class Test {
   private String caption = null;

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

He visto soluciones en las que se cambia el nombre del campo, es decir, "fCaption", pero eso provocaría que los captadores / establecedores automáticos que se pueden generar tengan nombres impares (getfCaption()) No ilegible, pero feo ...

Editar: Ah, sí, existe la posibilidad de cambiar el nombre de la firma del métodoTest(String caption_) o algo similar, pero eso terminaría en el javadoc luciendo raro.