Java实现待办工具：JavaList实战教程

对于一个文章开发者来说，牢固扎实的基础是十分重要的，golang学习网就来带大家一点点的掌握基础知识点。今天本篇文章带大家了解《Java实现命令行待办工具：JavaList实战教程》，主要介绍了，希望对大家的知识积累有所帮助，快点收藏起来吧，否则需要时就找不到了！

推荐用 picocli 解析命令行参数，它通过注解自动处理帮助页、类型转换和错误提示；ArrayList 存任务足够，退出时用 JSON 持久化；日期用自定义转换器支持多格式输入，存储统一为 ISO 格式；输出用 printf 保证对齐。

命令行参数解析用 args 还是第三方库？

Java 原生 main(String[] args) 能跑，但一碰到 --add "买牛奶" 或 -l --due 2024-12-31 就容易写成一堆 if-else 和索引越界。硬解析不光难维护，还容易漏掉空值、引号嵌套、短选项合并（如 -al）等边界情况。

推荐直接用 picocli——它通过注解绑定参数，自动处理帮助页、类型转换、错误提示，且单文件可运行（无依赖冲突）：

@Command(name = "todo", mixinStandardHelpOptions = true)
public class TodoApp implements Runnable {
  @Option(names = {"-a", "--add"}, description = "添加待办事项")
  String addText;

  @Option(names = {"-l", "--list"}, description = "列出所有事项")
  boolean list;

  @Option(names = {"--due"}, description = "按截止日期过滤，格式：yyyy-MM-dd")
  LocalDate dueDate;

  public void run() {
    if (addText != null) {
      addItem(addText);
    } else if (list) {
      listItems(dueDate);
    }
  }
}

启动时只需：

new CommandLine(new TodoApp()).execute(args);

ArrayList 存任务够用吗？要不要加线程安全或持久化？

纯命令行工具首次启动没状态，ArrayList 完全够用——增删查都是 O(1) 或 O(n)，几十条任务毫无压力。别一上来就上 ConcurrentHashMap 或数据库，Java 启动慢、I/O 拖累体验。

但必须考虑两个现实问题：

• TodoItem 类至少得有 id（自增）、text、done、createdAt、dueDate 字段，否则排序/过滤没法做
• 退出前不保存，下次启动就丢数据——用 Files.write(Paths.get("todo.json"), jsonBytes) 写本地文件最轻量；避免用 ObjectOutputStream（二进制不兼容、不可读）

日期输入怎么校验和存储才不踩坑？

用户输 --due 2024/12/31 或 --due 31-12-2024 是常态，不能靠 LocalDate.parse() 硬扛。picocli 支持自定义类型转换器：

static class LocalDateConverter implements ITypeConverter {
  public LocalDate convert(String value) throws Exception {
    for (String pattern : Arrays.asList("yyyy-MM-dd", "yyyy/MM/dd", "dd-MM-yyyy")) {
      try {
        return LocalDate.parse(value, DateTimeFormatter.ofPattern(pattern));
      } catch (DateTimeParseException ignored) {}
    }
    throw new IllegalArgumentException("无法解析日期: " + value);
  }
}

然后在字段上声明：

@Option(names = "--due", converter = LocalDateConverter.class) LocalDate dueDate;

存储一律用 ISO 格式（"2024-12-31"），避免时区和解析歧义；显示时再按用户习惯格式化。

为什么输出用 System.out.printf 而不是字符串拼接？

列表要对齐（ID、状态、文字、日期），比如：

 1 [ ] 买牛奶                 2024-12-31
 2 [x] 整理代码库             —

手动拼空格极易错位，尤其中文字符占位不一致。printf 的宽度控制可靠得多：

System.out.printf("%2d [%s] %-20s %s%n",
  item.getId(),
  item.isDone() ? "x" : " ",
  item.getText(),
  item.getDueDate() != null ? item.getDueDate() : "—");

注意：%-20s 左对齐占 20 位，%2d 右对齐占 2 位，%n 是跨平台换行符——别用 \n，Windows 下会显示异常。

真正麻烦的是中文对齐：Java 默认等宽字体下，一个中文 ≈ 两个英文宽度，但 printf 按字符数算。如果需求严格对齐，得先用 StringUtils.length()（Apache Commons）估算显示宽度，再动态补空格——多数 CLI 工具选择妥协，靠左对齐+固定缩进而非绝对列对齐。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java实现待办工具：JavaList实战教程》文章吧，也可关注golang学习网公众号了解相关技术文章。