推荐用 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 拖累体验。
立即学习“Java免费学习笔记（深入）”；
但必须考虑两个现实问题：
-
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 工具选择妥协，靠左对齐+固定缩进而非绝对列对齐。
