Java初学者项目实战：实现简单的地址簿管理工具_技术教程

Contact类需定义全参构造方法、封装字段、重写equals/hashCode/toString，AddressBook类封装增删改查，Scanner输入统一用nextLine()并做空值防护，对象声明即初始化以防NPE。

Java初学者做地址簿项目，最常卡在「不知道从哪开始封装」和「一写增删改查就变成一堆静态方法堆砌」——这说明没理清对象职责。直接用 ArrayList 存数据、用 Scanner 做交互、把业务逻辑全塞进 Main 类，短期能跑，但加个导出功能就崩溃。

怎么设计 Contact 类才不算“假面向对象”

很多初学者的 Contact 只有 String name、String phone 字段，连构造方法都省了，后续想校验手机号格式或合并重复联系人时无从下手。

必须定义全参构造方法，强制初始化关键字段（比如 name 不应为 null）
phone 字段建议用 private String phone + public String getPhone()，方便后续加正则校验逻辑
重写 equals() 和 hashCode()：否则用 list.remove(contact) 会删不掉——默认比较的是内存地址
重写 toString()：调试和打印列表时直接输出可读内容，不用每次手动拼接

public class Contact {
    private final String name;
    private String phone;

    public Contact(String name, String phone) {
        if (name == null || name.trim().isEmpty()) {
            throw new IllegalArgumentException("姓名不能为空");
        }
        this.name = name.trim();
        this.phone = phone == null ? "" : phone.trim();
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Contact contact = (Contact) o;
        return Objects.equals(name, contact.name) &&
               Objects.equals(phone, contact.phone);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name, phone);
    }

    @Override
    public String toString() {
        return "Contact{name='" + name + "', phone='" + phone + "'}";
    }
}

为什么 Scanner 读整行比 nextLine() 更安全

用 scanner.next() 读姓名，再用 scanner.nextLine() 读电话，大概率会跳过第一行电话输入——因为 next() 不吞掉换行符，nextLine() 立刻读到空字符串。这是初学者最常遇到的「输入消失」问题。

统一用 scanner.nextLine() 获取所有输入，包括数字（再用 Integer.parseInt() 转）
对空输入做防护：比如用户直接回车，应提示「姓名不能为空」而不是抛 NumberFormatException
把 Scanner 封装成工具方法，避免在多个地方重复写 try-catch

public static String readNonEmptyLine(Scanner scanner, String prompt) {
    System.out.print(prompt);
    String input = scanner.nextLine().trim();
    while (input.isEmpty()) {
        System.out.print("输入不能为空，请重新" + prompt);
        input = scanner.nextLine().trim();
    }
    return input;
}

增删改查逻辑该放在哪里

别把所有操作都写在 main() 里。初学者容易写成：一个 while(true) 循环里塞满 if-else，每个分支调一堆 System.out.println() 和 scanner。这不是管理工具，是交互脚本。

建一个 AddressBook 类，持有一个 private List contacts = new ArrayList();
增删改查全部作为 AddressBook 的实例方法，比如 addContact(Contact c)、findByName(String name)
Main 类只负责调度：显示菜单 → 读用户选型 → 调 addressBook.xxx() → 打印结果
搜索功能优先用 stream().filter()，比手写 for 循环更贴近实际开发习惯（也更难出错）

public List findByName(String keyword) {
    return contacts.stream()
            .filter(c -> c.getName().contains(keyword))
            .collect(Collectors.toList());
}

运行时报 NullPointerException 却找不到哪行错

常见于：声明了 AddressBook book; 但没写 book = new AddressBook();，然后直接调 book.addContact(...)。栈信息里只显示

NullPointerException，没指明是 book 还是 contact 为空。

所有对象型变量，声明即初始化：比如 private AddressBook book = new AddressBook();
方法参数做非空检查：比如 addContact(Contact c) 开头加 Objects.requireNonNull(c, "联系人不能为null")
集合类不要用原始类型：用 List 而不是 List，IDE 和编译器能提前报错
启动时加 JVM 参数 -XX:+ShowCodeDetailsInExceptionMessages（JDK 14+），能让 NPE 显示具体字段名

真正卡住初学者的，从来不是语法，而是没想清楚「谁该负责什么」。Contact 不该知道怎么存文件，AddressBook 不该处理控制台颜色，Main 不该校验手机号格式。边界划清楚了，加功能才不会牵一发而动全身。