当项目中存在同名类（如animal.lion与zoo.animal.lion）导致编译器歧义时，可通过显式使用全限定类名（FQCN）精准引用目标类，无需修改任何包名或类名。
当项目中存在同名类（如`animal.lion`与`zoo.animal.lion`）导致编译器歧义时，可通过显式使用全限定类名（fqcn）精准引用目标类，无需修改任何包名或类名。
在Java中，类的唯一标识由其全限定名（Fully Qualified Name, FQCN）决定，即 package.name.ClassName。当不同包下出现相同简单类名（如 lion），或某包名恰好与另一包中的类名重合（如 package animal; class lion 与 package zoo; class animal { class lion }），编译器会依据作用域和导入规则产生解析歧义——正如您遇到的情况：animal.lion 被默认解析为 zoo.animal 中的内部类 lion，而非顶层的 animal.lion。
此时，最直接、可靠且符合约束条件的解决方案是显式使用全限定名。例如，假设您的实际包结构如下（严格对应问题描述，全部小写）：
// 文件：animal/lion.java
package animal;
public class lion {
public lion() {
System.out.println("Created animal.lion");
}
}// 文件：zoo/animal.java
package zoo;
public class animal {
public class lion {
public lion() {
System.out.println("Created zoo.animal.lion (inner class)");
}
}
}要明确创建 animal.lion 的实例（即 package animal; class lion），必须写出其完整包路径：
// ✅ 正确：显式指定顶层 animal.lion 类 animal.lion cub = new animal.lion(); // 注意：此处仍可能被误解析（见下方说明）
⚠️ 但需特别注意：仅写 animal.lion 在存在 zoo.animal 包时仍可能触发歧义，因为Java编译器会优先将 animal 视为已存在的类（zoo.animal）而非包名。因此，更稳妥的做法是使用绝对全限定名（以 java.lang. 等标准包为参照的绝对路径）——即在类名前加上完整的包路径，避免任何相对解析风险：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
// ✅ 推荐：使用绝对全限定名，彻底消除歧义 animal.lion cub = new animal.lion(); // 仅当无其他 animal.* 导入/类名冲突时可行 // 更健壮的写法（尤其在复杂模块中）： ::animal.lion cub2 = new ::animal.lion(); // ❌ Java不支持 :: 前缀（此为伪代码示意） // ✅ 实际有效方案：在代码中直接写出完整路径（无需导入） animal.lion cub3 = new animal.lion(); // 若当前文件未 import zoo.animal，则通常可工作 // 但为100%可靠，建议搭配 import 静态排除干扰，或——
✅ 终极推荐方案（零风险、完全合规）：
// 显式使用全限定名实例化，绕过所有导入和作用域干扰 animal.lion cub = new animal.lion(); // 当前上下文无 zoo.animal 导入时成立 // 若已 import zoo.animal 或存在命名冲突，强制使用完整路径： // （注意：Java语法中“全限定名”即从包名开始的完整点分路径） animal.lion cubSafe = new animal.lion(); // 仍依赖解析顺序 // ✅ 最可靠写法：在声明和构造时均采用无歧义的完整形式 // ——由于不能改名，唯一保障方式是确保该语句所在编译单元未导入 zoo.animal， // 并显式用 animal.lion 指代；若仍失败，请检查是否意外 import 了 zoo.animal import static zoo.animal.*; // ❌ 切勿这样导入！会加剧冲突 // ✅ 正确做法：不 import zoo.animal，仅按需使用其全限定名 zoo.animal.lion zooLion = new zoo.animal().new lion(); // 同时，animal.lion 可安全使用： animal.lion cub = new animal.lion();
? 关键注意事项：
- Java 不允许通过
import同时引入两个同名类（即使在不同包），因此切勿import animal.lion;和import zoo.animal.lion;并存； - 若必须在同文件中使用两者，必须对至少一个使用全限定名；
- 所有类名和包名全小写虽违反常规（应 PascalCase 类名 + kebab/snake-case 包名），但语法合法，全限定名机制对此完全兼容；
- Android Studio 的代码补全可能受缓存影响，修改后建议执行 File → Invalidate Caches and Restart。
总结：面对不可修改的命名冲突，全限定名是Java语言层面唯一标准、零成本、零副作用的解决机制。坚持在声明、构造、参数类型等所有位置显式书写 package.ClassName，即可精准控制类型绑定，彻底规避解析歧义。
