包用于组织和命名类以避免冲突，类路径则告诉JVM从何处加载字节码；二者分别负责逻辑命名与物理定位，紧密配合确保Java程序正确编译与运行。
Java 包（Package）和类路径（Classpath）是 Java 程序能正确编译、加载和运行的两个基础机制。简单说：包用来组织和命名类，避免冲突；类路径告诉 JVM 到哪儿去找这些类。它们不直接等价，但紧密配合——写代码时靠包管理结构，运行时靠类路径定位字节码。
包：给类起“带地址的全名”
包本质是命名空间，让类名具备层级结构，防止不同来源的同名类互相覆盖。比如 java.util.Date 和 java.sql.Date 是完全不同的类，靠包名区分。
- 包名通常对应目录结构：声明 package com.example.utils;，源文件就得放在 com/example/utils/ 目录下
- 编译后生成的 .class 文件也要保持相同目录结构
- 用 import 可简化使用：写 import java.util.ArrayList; 后，就能直接写 ArrayList list = new ArrayList();
- 默认包（不写 package）虽然允许，但不推荐——它无法被其他包 import，也不利于模块化
类路径：JVM 的“文件搜索地图”
类路径是一组路径（目录或 JAR 文件），JVM 根据它来查找并加载所需的 .class 文件。它不是源码路径，而是编译后字节码所在的位置。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 可以是绝对路径，也可以是相对路径；多个路径用分号（Windows）或冒号（macOS/Linux）分隔
- 常见形式：java -cp ".;lib/commons-lang3.jar" MyApp（Windows）或 java -cp ".:lib/commons-lang3.jar" MyApp（macOS/Linux）
- . 表示当前目录——JVM 会在这里找默认包下的类，或按包名子目录查找（如 com/example/Utils.class 要在 ./com/example/Utils.class）
- 没设类路径时，JVM 默认只查当前目录（.）；JDK 自带类（如 java.lang.*）始终可用，不依赖 classpath
典型错误和怎么查
遇到 ClassNotFoundException 或 NoClassDefFoundError，八成是类路径问题；而 Duplicate class 或编译报错“找不到符号”，常是包结构或 import 写错了。
立即学习“Java免费学习笔记（深入）”；
- 检查 .class 文件是否真在类路径指定的目录里，且包目录结构完整
- 确认 jar 包有没有漏加——比如用了 Log4j 却没把 log4j-core.jar 放进 classpath
- IDE（如 IntelliJ 或 Eclipse）自动管理类路径，但导出为 jar 或命令行运行时，必须手动配好
- 用 java -verbose:class -cp ... MyApp 可看 JVM 实际加载了哪些类、从哪加载的
基本上就这些。包是写代码时的逻辑组织，类路径是运行时的物理定位——一个管“叫什么”，一个管“在哪找”。理解清楚各自职责，再配合正确的目录结构和命令行参数，Java 的类加载就不再玄学。
