Java读取文件过滤注释与空行方法

本文深入剖析了Java中读取文本文件时精准过滤注释行（//）、节标题（[xxx]）和空行的关键技巧，直击开发者常踩的逻辑陷阱——因忽视运算符优先级与语义错误（如误用startsWith("/")而非"//")导致过滤完全失效，并通过正则表达式、清晰条件重构、资源安全管理和异常精细化处理，提供了一套健壮、可维护的CSV数据解析方案，同时贴心提示进阶实践：在生产环境中拥抱Apache Commons CSV等专业库，让文件处理更可靠、更高效。

本文详解 Java 中使用 Scanner 读取文本文件时，如何准确跳过以 `//` 开头的注释行、方括号节标题（如 `[ElectricTool data]`）及空白行，并正确解析 CSV 格式工具数据，重点修正原始代码中因逻辑运算符优先级错误导致的 if 条件失效问题。

在 Java 文件处理实践中，一个常见却易被忽视的问题是：看似合理的过滤条件在运行时完全失效。典型案例如题——开发者希望跳过注释行（//）、节标题（[ 开头）和空行，但实际输出仍包含全部原始内容。根本原因在于原始代码中布尔表达式逻辑错误：

if (!lineOfText.startsWith("/") && !lineOfText.startsWith("[") || lineOfText.isEmpty())

该条件存在两大缺陷：

1. 语义错误：startsWith("/") 判断的是单个 /，而示例文件中注释为 //，应使用 startsWith("//")；
2. 逻辑优先级陷阱：&& 优先级高于 ||，上述表达式等价于 (!A && !B) || C，即“只要行为空就执行解析”，彻底绕过过滤逻辑——这正是“if 不工作”的根源。

✅ 正确做法是：仅当行非空且不匹配跳过模式时，才进行解析。推荐使用正则表达式提升可读性与健壮性：

// 定义需跳过的行模式：以 // 开头，或以 [ 开头（支持 [xxx] 形式）
Pattern ptrnSkip = Pattern.compile("^(?://|\\[).*$");

完整修复后的 readToolData() 方法如下（已整合资源自动关闭、增强容错与日志）：

public void readToolData() {
    Frame myFrame = new Frame();
    FileDialog fileName = new FileDialog(myFrame, "Select the file to load", FileDialog.LOAD);
    fileName.setDirectory("/");
    fileName.setVisible(true);

    // 安全检查：确保目录和文件名均非 null
    if (fileName.getDirectory() == null || fileName.getFile() == null) {
        System.out.println("No file selected");
        return;
    }

    String filePath = fileName.getDirectory() + fileName.getFile();
    System.out.printf("Selected file: %s\n", filePath);

    File fileData = new File(filePath);
    try (Scanner scnrFile = new Scanner(fileData)) {
        // 跳过行的正则：// 开头 或 [ 开头（含 [Section] 类型）
        Pattern ptrnSkip = Pattern.compile("^(?://|\\[).*$");
        // CSV 分隔符正则：逗号 + 可选空格
        Pattern ptrnDlim = Pattern.compile(" *, *");

        while (scnrFile.hasNextLine()) {
            String line = scnrFile.nextLine().trim();

            // ✅ 关键修复：仅当行非空且不匹配跳过模式时处理
            if (!line.isEmpty() && !ptrnSkip.matcher(line).find()) {
                System.out.printf("Processing: \"%s\"\n", line);

                try (Scanner scnrLine = new Scanner(line).useDelimiter(ptrnDlim)) {
                    // 按预期字段顺序解析（注意空格容错）
                    String toolName = scnrLine.next().trim();
                    String toolCode = scnrLine.next().trim();
                    int timesBorrowed = scnrLine.nextInt();
                    boolean onLoan = scnrLine.nextBoolean();
                    int cost = scnrLine.nextInt();
                    int weight = scnrLine.nextInt();
                    boolean rechargeable = scnrLine.nextBoolean();
                    String power = scnrLine.next().trim();

                    // 构造并存储 Tool 对象（此处仅示意）
                    Tool t = new Tool(toolName, toolCode, timesBorrowed, 
                                     onLoan, cost, weight, rechargeable, power);
                    this.storeTool(t);
                }
            } else {
                System.out.printf("Skipped: \"%s\"\n", line);
            }
        }
    } catch (FileNotFoundException e) {
        System.err.println("File not found: " + e.getMessage());
        e.printStackTrace();
    } catch (InputMismatchException e) {
        System.err.println("Data format error in line: " + e.getMessage());
    }
}

? 关键改进说明：

• 逻辑重构：将 if 条件明确为 !line.isEmpty() && !ptrnSkip.matcher(line).find()，语义清晰且无优先级歧义；
• 正则精准匹配：^(?://|\[).*$ 确保只跳过行首的 // 或 [，避免误删含 / 的正常数据（如 "10.8V"）；
• 资源安全：使用 try-with-resources 自动关闭 Scanner，防止句柄泄漏；
• 异常细化：捕获 InputMismatchException 应对 CSV 解析类型不匹配（如字符串误作整数），提升调试效率；
• 空格鲁棒性：.trim() 和分隔符正则 *, * 共同处理字段间冗余空格。

? 进阶建议：
对于生产环境，强烈推荐使用专业 CSV 库替代手写解析，例如 Apache Commons CSV。它内置 RFC4180 兼容、引号转义、多行字段等特性，可大幅降低解析错误风险。简要示例：

try (Reader reader = Files.newBufferedReader(Paths.get(filePath));
     CSVParser parser = CSVFormat.DEFAULT.withFirstRecordAsHeader().parse(reader)) {
    for (CSVRecord record : parser) {
        String name = record.get("toolName");
        int cost = Integer.parseInt(record.get("cost"));
        // ... 安全解析
    }
}

始终牢记：文件过滤的本质是“显式声明保留条件”，而非“尝试排除所有坏情况”。用清晰的正则定义“什么是有效数据”，比堆砌多个 startsWith() 和 isEmpty() 更可靠、更可维护。

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