java局部变量遮蔽非语法错误但易致行为异常，主要发生在构造器/方法参数与成员变量同名、块内重声明同名变量、子类与父类实例变量同名三类场景，需用this.、前缀命名等方式明确访问目标。
Java里局部变量遮蔽（shadowing）不是语法错误，但会让代码行为和预期不一致——比如成员变量没被赋值、方法参数改了自己、测试时值始终是默认值。关键在于识别遮蔽发生的位置，并用清晰、安全的方式访问目标变量。
哪些地方最容易发生遮蔽
遮蔽集中在三类常见场景，都是因为“同名 + 不同作用域”同时出现：
-
构造器或方法中，参数名与成员变量名相同：如
public void setName(String name)，参数name遮蔽了this.name -
在 if/for/try 块内重新声明同名局部变量：如外层有
int count = 5;，块里写int count = 10;，外层的count就不可见了 -
子类定义了与父类同名的实例变量：如父类有
String id;，子类又写String id;，调用时this.id指的是子类自己的字段，父类字段被遮蔽
怎么一眼看出遮蔽正在发生
IDE 通常会高亮提示，但你也可以自己快速判断：
- 写完赋值语句后，运行结果和预期不符（比如对象字段还是
null或0），先检查构造器或 setter 里有没有重复声明 - 鼠标悬停变量名，看 IDE 显示的类型和声明位置——如果显示“local variable”而非“field”，说明它被遮蔽了
- 在遮蔽发生的作用域内，直接写变量名不加前缀，编译器不会报错，但实际操作的不是你想的那个变量
安全可靠的应对方式
不要依赖遮蔽去“覆盖含义”，而要让每个变量名都指向唯一明确的目标：
-
成员变量统一加前缀或后缀：如
mName、name_或userName，让参数名（如newName）自然区分开 -
必须访问被遮蔽的成员变量时，显式用
this.：如this.value = value;，语义清晰且无歧义 -
静态字段被遮蔽，用
ClassName.field访问：避免只写field = ...导致赋值到局部变量 -
内部类访问外部类同名字段，用
OuterClass.this.field：不能只靠名字推断层级
特别注意构造器里的初始化陷阱
这是单元测试失败的高频原因：
- 错误写法：
public Person(String name) { String name = name; }→ 新建局部变量，成员变量未动 - 正确写法一：
this.name = name;（推荐，简洁明确） - 正确写法二：
public Person(String inputName) { this.name = inputName; }（从命名上就切断遮蔽可能）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
