JavaIO流实现日记本：文本读写与控制台操作

本文深入解析了如何用Java IO流打造一个健壮、易用的文本日记本应用，重点强调控制台交互的安全性与文件读写的可靠性：摒弃易出错的Scanner，采用BufferedReader包装System.in确保逐行输入稳定；推荐使用Files.write()配合APPEND/CREATE选项和UTF-8编码实现安全追加写入，避免乱码与路径异常；读取时通过Files.readAllLines()配合NoSuchFileException捕获和空列表判空实现容错加载；同时倡导将日记路径封装为静态常量并优先定位至用户主目录，兼顾可移植性与中文支持。全文直击初学者常见坑点——换行符残留、编码不一致、硬编码路径、空文件误判等，提供即学即用的生产级实践方案。

用 BufferedReader + System.in 做控制台输入，别直接用 Scanner

控制台交互时，Scanner 遇到换行或空格容易吃掉后续输入，尤其在读完一行再读日期、标题时经常丢数据。用 BufferedReader 包裹 System.in 更可控。

• Scanner 的 nextLine() 和 nextInt() 混用会残留换行符，导致下一次 nextLine() 直接返回空字符串
• BufferedReader.readLine() 总是读完整行，行为确定，适合日记这种“一行一字段”的场景
• 记得在 try-with-resources 里声明，避免 System.in 被意外关闭（虽然它关不掉，但写法要一致）

示例：获取日记标题

BufferedReader console = new BufferedReader(new InputStreamReader(System.in));
System.out.print("请输入标题：");
String title = console.readLine().trim();

写日记用 Files.write() 追加模式，不是 FileWriter

日记本的核心是“追加”，不是覆盖。用 FileWriter 开启 true 参数看似可行，但它不处理换行、编码、路径不存在等问题；而 Files.write() 是 Java 7+ 推荐的现代方式，天然支持 UTF-8 和自动创建父目录。

• 必须显式传入 StandardOpenOption.APPEND，否则默认覆盖
• 一定要加 StandardOpenOption.CREATE，否则文件不存在时抛 NoSuchFileException
• 别漏掉 Charset.forName("UTF-8")，Windows 控制台默认 GBK，不指定会导致中文乱码
• 每条日记建议以换行开头（即先写 "\n"），避免首行粘连或空行缺失

示例：追加一条格式化日记

String entry = "\n[" + new Date() + "] " + title + "\n" + content;
Files.write(Paths.get("diary.txt"), entry.getBytes(StandardCharsets.UTF_8),
             StandardOpenOption.CREATE, StandardOpenOption.APPEND);

读日记用 Files.readAllLines() 要小心内存和空文件

显示历史日记时，想一次性加载全部内容最方便，但 Files.readAllLines() 会把整个文件读进内存。对日记本来说一般没问题，但得防两种边界情况：文件不存在、文件为空。

• 文件不存在时抛 NoSuchFileException，必须捕获，不能假设它一定存在
• 空文件返回空 List，不是 null，所以判空要用 list.isEmpty()，不是 list == null
• 如果日记量极大（比如上万条），改用 Files.lines() 流式处理，但日常使用没必要
• 注意行尾换行符已被剥离，显示时需手动补 \n 或用 System.lineSeparator()

示例：安全读取并打印

try {
    List lines = Files.readAllLines(Paths.get("diary.txt"), StandardCharsets.UTF_8);
    if (lines.isEmpty()) {
        System.out.println("暂无日记");
    } else {
        lines.forEach(System.out::println);
    }
} catch (NoSuchFileException e) {
    System.out.println("日记文件不存在，尚未写入任何内容");
}

路径硬编码成 "diary.txt" 很危险，至少封装成常量

开发时图省事写死路径，上线后可能因工作目录变化导致文件写到奇怪位置，甚至权限失败。Java 没有全局配置概念，但一个静态常量比到处写字符串强得多。

• 路径尽量用相对路径，但确保它相对于用户期望位置（比如用户主目录：System.getProperty("user.home") + "/diary.txt"）
• 如果用当前目录，确认 IDE 或 jar 启动时的工作目录是否可控（IntelliJ 默认是项目根，jar 默认是执行目录）
• 不要用 File.separator 拼接路径，一律用 Paths.get(...)，它自动适配 Windows/Linux
• 路径中含中文时，Paths.get() 没问题，但某些旧终端或打包工具可能解析异常，测试时务必实测

示例：定义可维护路径

private static final Path DIARY_PATH = Paths.get(System.getProperty("user.home"), "my-diary.txt");

实际写的时候，最容易被忽略的是编码一致性——控制台输入、文件写入、文件读取三处都得明确指定 UTF_8，少一处就可能看到一堆问号或乱码。还有就是空文件和首次运行的异常分支，很多人只测了“已经写了好几条”的情况。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。