Java 類命名衝突：自定義 Long 類導致找不到符號錯誤

初學者常犯錯誤：自定義類名與 JDK 核心類重名（如 Long、String、Math），導致編譯器解析到錯誤類，報「找不到符號」或方法不存在錯誤。

問題代碼

import java.lang.*;

public class Long {  // 錯誤：與 java.lang.Long 衝突
    public static void main(String[] args) {
        long b1 = 0x300L;
        long b2 = 0200L;
        System.out.println("b1:" + Long.toBinaryString(b1)); // 調用的是自定義 Long 類
        System.out.println("b2:" + Long.toBinaryString(b2));
    }
}

錯誤原因

• import java.lang.*; 引入 java.lang.Long
• 本地定義 public class Long，同包無需導入即可見
• 編譯器按「最近原則」解析 Long 為本地類
• 本地類無 toBinaryString 靜態方法 → 編譯錯誤

解決方案

方案一：重命名自定義類（推薦）

public class LongDemo {  // 改為非衝突名
    public static void main(String[] args) {
        long b1 = 0x300L;
        long b2 = 0200L;
        System.out.println("b1:" + Long.toBinaryString(b1)); // 正確調用 java.lang.Long
        System.out.println("b2:" + Long.toBinaryString(b2));
    }
}

方案二：使用全限定名（不推薦，碼頭）

public class Long {
    public static void main(String[] args) {
        long b1 = 0x300L;
        System.out.println("b1:" + java.lang.Long.toBinaryString(b1)); // 強制指定
    }
}

避坑指南：禁用類名列表

最佳實踐

1. 類名加業務前綴：UserService、OrderController、LongConverter
2. 包名倒置域名：com.company.module，降低同包衝突概率
3. IDE 提示重視：IntelliJ/Eclipse 會警告「類名與 JDK 類衝突」
4. 靜態導入慎用：import static java.lang.Long.*; 更易產生歧義

補充：八進制/十六進制字面量

long b1 = 0x300L;  // 十六進制 0x300 = 768
long b2 = 0200L;   // 八進制 0200 = 128 (Java 7+ 支持 0o200 寫法)
long b3 = 0b1010L; // 二進制 (Java 7+)

輸出：

b1:1100000000
b2:10000000

總結

自定義類名 絕不可與 java.lang 包下類重名。遇到「找不到符號」「方法未定義」先檢查類名衝突。養成「業務前綴 + 功能後綴」命名習慣，從源頭杜絕此類低級錯誤。

1. 上一篇文章： Python 正則表達式詳解：re.findall 模式匹配原理與優化
2. 下一篇文章： Android GridView 實現指南：避免黑屏崩潰的關鍵錯誤與正確適配器寫法

程式設計綜合問答

MFC序列化學生管理系統：使用CListView實現表頭顯示與數據綁定

需求分析 基於MFC文檔/視圖架構，利用序列化機制持久化學生

C# 藍牙通信（InTheHand 库）常見錯誤與調試指南

錯誤現象 使用 InTheHand.Net.Bluetoot

C++ 經典坑：整數除法導致球體體積計算結果為 0

問題代碼 double v = 4 / 3 * pi * r

jQuery MultiSelect 下拉框高度自定義完全指南（含源碼修改方案）

問題背景 使用 jquery.multiselect 插件時