Kotlin 在 Java 的可见性修饰符基础上做了重新设计和扩展，既保留了类似的概念，又引入了更符合现代语言设计的机制。我们来详细对比一下：
🔹 Java 的可见性修饰符（访问控制）
| 修饰符 | 类内 | 同包 | 子类 | 全局 |
|---|---|---|---|---|
private | ✅ | ❌ | ❌ | ❌ |
| （默认，无修饰） | ✅ | ✅ | ❌ | ❌ |
protected | ✅ | ✅ | ✅ | ❌ |
public | ✅ | ✅ | ✅ | ✅ |
⚠️ Java 没有“模块级”可见性（直到 Java 9 引入模块系统，但使用不广泛）。
🔹 Kotlin 的可见性修饰符
Kotlin 简化并增强了可见性控制，主要有四个：
| 修饰符 | 可见范围 |
|---|---|
private | 仅在声明所在的文件（顶层）或类内部（成员）可见 |
internal | 同一模块（module）内所有地方可见 ✅ ← 这是 Kotlin 新增的核心特性 |
protected | 仅在子类中可见（不能用于顶层声明） |
public | 所有地方可见（默认） |
✅ 关键区别：Kotlin 没有“包私有”概念，而是用 internal 替代了“模块私有”，粒度更大、更实用。
🔸 Kotlin 对 Java 修饰符的“扩展”或“改进”
| Java 概念 | Kotlin 对应/替代方式 | 说明 |
|---|---|---|
| 包私有（默认） | 没有直接对应，通常用internal或private | Kotlin 认为“包”不是可靠的封装边界 |
protected | 保留，但不能用于顶层声明（如顶层函数/类） | 更安全，避免滥用 |
新增 internal | ✅ 核心扩展 | 提供“模块级”封装，非常适合库开发 |
| 默认可见性 | Java 是包私有；Kotlin 是 public | Kotlin 更倾向于显式控制 |
🌟 为什么说internal是重要扩展？
- Java 的痛点：\ Java 中想让一组类在“同一个库内部”互相访问，但对外隐藏，只能靠“放在同一个包 + 不写文档 + 约定不使用”。但这很脆弱（用户仍可访问），且包结构受限制。
- Kotlin 的方案：\ 用
internal明确标记“这是内部实现，外部不要用”。编译器会阻止其他模块访问，即使它们知道这个类存在。
// 我的库模块
internal class DatabaseHelper // ✅ 库内部自由使用// 用户项目（另一个模块）
val db = DatabaseHelper() // ❌ 编译错误！这比 Java 的包私有更安全、更清晰。
🔍 补充：Kotlin 的private更严格
- 在 Java 中，
private成员可通过同包内的其他类间接访问（比如通过嵌套类 trick）。 - 在 Kotlin 中：
- 顶层
private fun foo()→ 仅当前文件可见 - 类中的
private fun bar()→ 仅该类内部可见 - 文件成了一个天然的封装单元（类似“模块化文件”）
- 顶层
✅ 总结
Kotlin 并不是简单照搬 Java 的可见性，而是在其基础上做了现代化重构：
- 移除了模糊的“包私有”
- 新增了强大的****
internal（模块级可见） - 强化了****
private****的封装性 - 默认****
public，鼓励显式设计 API
所以，可以说 Kotlin 用internal填补了 Java 在“库内部封装”上的缺失，这是一个非常实用的扩展。
如果你在开发多模块项目或 SDK，internal会是你的好朋友！
更新: 2026-01-09 17:27:58
原文: https://www.yuque.com/dongpozhouzi-mshe3/zhm85g/hbonemit8n2g8mhg