Contact类需定义全参构造方法、封装字段、重写equals/hashCode/toString,AddressBook类封装增删改查,Scanner输入统一用nextLine()并做空值防护,对象声明即初始化以防NPE。
Java初学者做地址簿项目,最常卡在「不知道从哪开始封装」和「一写增删改查就变成一堆静态方法堆砌」——这说明没理清对象职责。直接用 ArrayList 存数据、用 Scanner 做交互、把业务逻辑全塞进 Main 类,短期能跑,但加个导出功能就崩溃。
很多初学者的 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.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 ListfindByName(String keyword) { return contacts.stream() .filter(c -> c.getName().contains(keyword)) .collect(Collectors.toList()); }
常见于:声明了 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 和编译器能提前报错-XX:+ShowCodeDetailsInExceptionMessages(JDK 14+),能让 NPE 显示具体字段名真正卡住初学者的,从来不是语法,而是没想清楚「谁该负责什么」。Contact 不该知道怎么存文件,AddressBook 不该处理控制台颜色,Main 不该校验手机号格式。边界划清楚了,加功能才不会牵一发而动全身。