Java 成員變量與局部變量同名問題：this 關鍵字消歧義指南

現象重現

public class Person {
    private int age = 1000; // 成員變量
    
    public void setAge(int age) { // 參數 age 為局部變量
        age = age; // ❌ 錯誤：局部變量賦值給自身
        System.out.println("方法內的年齡: " + age);
    }
    
    public void sayHello() {
        System.out.println("我的年齡是: " + age); // 訪問成員變量
    }
}

public static void main(String[] args) {
    Person p = new Person();
    p.setAge(20);
    p.sayHello();
}

// 輸出：
// 方法內的年齡: 20
// 我的年齡是: 1000  ← 成員變量未被修改！

核心規則

方法內變量名優先匹配局部變量（參數/內部定義）；若無同名局部變量，則匹配成員變量。

• 同名時：方法內 age 只代表局部變量，與成員變量無任何關係
• 不同名時：方法內 age 代表成員變量

內存與生命週期解析

1. 創建對象時：成員變量 age=1000 在堆內存中初始化
2. 調用 setAge(20)：
• 棧幀創建，局部變量 age=20 入棧
• age = age 只是局部變量自賦值，成員變量未被觸碰
• 方法結束，棧幀銷毀，局部變量 20 消失
3. 調用 sayHello()：訪問堆中成員變量，仍為 1000

解決方案：this 關鍵字

public class Person {
    private int age = 1000;
    
    public void setAge(int age) {
        this.age = age; // ✅ this.age 明確指向「當前對象的成員變量」
        System.out.println("方法內的年齡: " + age);
    }
    
    public void sayHello() {
        System.out.println("我的年齡是: " + age); // 這裡 age 隱含 this.age
    }
}

// 輸出：
// 方法內的年齡: 20
// 我的年齡是: 20  ← 成員變量成功修改！

this 關鍵字深度理解

• 含義：代表當前調用方法的對象引用
• 作用：消除同名變量歧義、構造器鏈式調用、返回當前對象
• 本質：編譯器隱式傳遞的參數，非靜態方法第一個隱藏參數

進階：構造器中的 this

public class Person {
    private String name;
    private int age;
    
    // 構造器鏈式調用
    public Person() {
        this("匿名", 0); // 必須是第一條語句
    }
    
    public Person(String name) {
        this(name, 0);
    }
    
    public Person(String name, int age) {
        this.name = name; // 消歧義
        this.age = age;
    }
    
    // 返回當前對象，支持鏈式調用
    public Person setName(String name) {
        this.name = name;
        return this;
    }
}

// 使用
Person p = new Person().setName("張三").setAge(25);

最佳實踐建議

總結

同名變量遮蔽是 Java 語言設計的特性，而非缺陷。理解作用域優先級（局部 > 成員）並善用 this 消歧義，是寫出正確 Java 代碼的基本功。多寫代碼、多調試觀察內存變化，自然能內化為直覺。