Day 6 · Todo CLI 项目(上)

Week 1 · Day 6 / 56 · 预计 2 小时 · 返回大纲

一、项目目标

用前 5 天学的知识,写一个完整的命令行 Todo 任务管理器。这是你第一个真正的 Python 项目。

JavaScript 世界
// Node.js CLI 工具
// npm install commander
const { program } = require('commander');

program
  .command('add')
  .argument('', '任务描述')
  .action((task) => {
    console.log('添加任务:', task);
  });

program.parse();
Python 世界
# Python CLI 工具
# 内置 argparse,无需安装
import argparse

parser = argparse.ArgumentParser(
    description='Todo 任务管理器'
)
subparsers = parser.add_subparsers(
    dest='command'
)

add_parser = subparsers.add_parser('add')
add_parser.add_argument('task', help='任务描述')

args = parser.parse_args()
if args.command == 'add':
    print(f'添加任务: {args.task}')

二、项目结构

todo/
├── todo.py          # 主程序
├── storage.py       # 数据存储
└── tasks.json      # 任务数据(自动生成)

三、第一步:数据模型

每个任务包含:

字段类型说明
idint唯一标识
contentstr任务内容
donebool是否完成
created_atstr创建时间

storage.py

import json
from datetime import datetime
from pathlib import Path

DATA_FILE = Path(__file__).parent / 'tasks.json'

def load_tasks():
    """从文件加载任务列表"""
    if DATA_FILE.exists():
        with open(DATA_FILE, 'r', encoding='utf-8') as f:
            return json.load(f)
    return []

def save_tasks(tasks):
    """保存任务列表到文件"""
    with open(DATA_FILE, 'w', encoding='utf-8') as f:
        json.dump(tasks, f, ensure_ascii=False, indent=2)

def add_task(content):
    """添加新任务"""
    tasks = load_tasks()
    task = {
        'id': len(tasks) + 1,
        'content': content,
        'done': False,
        'created_at': datetime.now().strftime('%Y-%m-%d %H:%M')
    }
    tasks.append(task)
    save_tasks(tasks)
    return task

四、第二步:命令行解析

用 argparse 实现子命令:

todo.py

import argparse
from storage import load_tasks, save_tasks, add_task

def main():
    parser = argparse.ArgumentParser(description='Todo 任务管理器')
    subparsers = parser.add_subparsers(dest='command', help='可用命令')

    # add 命令
    add_parser = subparsers.add_parser('add', help='添加任务')
    add_parser.add_argument('content', help='任务内容')

    # list 命令
    subparsers.add_parser('list', help='列出所有任务')

    # done 命令
    done_parser = subparsers.add_parser('done', help='标记任务完成')
    done_parser.add_argument('id', type=int, help='任务 ID')

    # delete 命令
    del_parser = subparsers.add_parser('delete', help='删除任务')
    del_parser.add_argument('id', type=int, help='任务 ID')

    args = parser.parse_args()

    if args.command == 'add':
        task = add_task(args.content)
        print(f'✅ 添加任务 #{task["id"]}: {task["content"]}')

    elif args.command == 'list':
        tasks = load_tasks()
        if not tasks:
            print('📝 暂无任务')
        for t in tasks:
            status = '✓' if t['done'] else '○'
            print(f'{status} #{t["id"]} {t["content"]} ({t["created_at"]})')

    elif args.command == 'done':
        tasks = load_tasks()
        for t in tasks:
            if t['id'] == args.id:
                t['done'] = True
                save_tasks(tasks)
                print(f'✅ 完成任务 #{args.id}')
                return
        print(f'❌ 找不到任务 #{args.id}')

    elif args.command == 'delete':
        tasks = load_tasks()
        tasks = [t for t in tasks if t['id'] != args.id]
        save_tasks(tasks)
        print(f'🗑️ 删除任务 #{args.id}')

    else:
        parser.print_help()

if __name__ == '__main__':
    main()

五、运行效果

$ python todo.py add "学习 Python argparse"
✅ 添加任务 #1: 学习 Python argparse

$ python todo.py add "写 Day 6 笔记"
✅ 添加任务 #2: 写 Day 6 笔记

$ python todo.py list
○ #1 学习 Python argparse (2026-09-18 14:30)
○ #2 写 Day 6 笔记 (2026-09-18 14:31)

$ python todo.py done 1
✅ 完成任务 #1

$ python todo.py list
✓ #1 学习 Python argparse (2026-09-18 14:30)
○ #2 写 Day 6 笔记 (2026-09-18 14:31)

$ python todo.py delete 2
🗑️ 删除任务 #2

六、JavaScript vs Python 对比

功能Node.js (commander)Python (argparse)
定义命令program.command('add')subparsers.add_parser('add')
参数.argument('')add_argument('task')
解析program.parse()parser.parse_args()
取值action callbackargs.command
💡 提示:Python 的 argparse 是标准库,不需要安装任何第三方包。而 JavaScript 生态需要 npm install commander 或 yargs。

七、练习

练习 1:添加优先级

给任务加 priority 字段(high/medium/low),默认 medium。

# add_task 函数修改
def add_task(content, priority='medium'):
    tasks = load_tasks()
    task = {
        'id': len(tasks) + 1,
        'content': content,
        'priority': priority,
        'done': False,
        'created_at': datetime.now().strftime('%Y-%m-%d %H:%M')
    }
    tasks.append(task)
    save_tasks(tasks)
    return task

# argparse 加参数
add_parser.add_argument('--priority', '-p', 
    choices=['high', 'medium', 'low'], default='medium')

练习 2:按优先级排序显示

list 命令按优先级从高到低排序。

elif args.command == 'list':
    tasks = load_tasks()
    priority_order = {'high': 0, 'medium': 1, 'low': 2}
    tasks.sort(key=lambda x: priority_order.get(x['priority'], 1))
    for t in tasks:
        status = '✓' if t['done'] else '○'
        print(f'{status} [{t["priority"]}] #{t["id"]} {t["content"]}')

练习 3:搜索功能

添加 search <关键词> 命令,模糊匹配任务内容。

# argparse
search_parser = subparsers.add_parser('search', help='搜索任务')
search_parser.add_argument('keyword', help='搜索关键词')

# 逻辑
elif args.command == 'search':
    tasks = load_tasks()
    results = [t for t in tasks if args.keyword in t['content']]
    for t in results:
        status = '✓' if t['done'] else '○'
        print(f'{status} #{t["id"]} {t["content"]}')

练习 4:清空已完成

添加 clear-done 命令,删除所有已完成的任务。

# argparse
subparsers.add_parser('clear-done', help='清空已完成任务')

# 逻辑
elif args.command == 'clear-done':
    tasks = load_tasks()
    before = len(tasks)
    tasks = [t for t in tasks if not t['done']]
    save_tasks(tasks)
    print(f'🗑️ 清空 {before - len(tasks)} 个已完成任务')

八、打卡验收

理解了 argparse 的基本用法,会创建 parser 和子命令
会用 subparsers 实现 add、list、done、delete 四个命令
理解了 JSON 文件存储,会用 json.load() 和 json.dump()
完成了 Todo CLI 核心功能,能添加、列出、完成、删除任务
对比了 JS commander 和 Python argparse 的差异
理解了 Path 对象的优势,会用 Path(__file__).parent 定位文件
完成了至少 2 个练习,代码能跑通
运行测试了所有命令,输出符合预期
打卡方式: 全部勾选后,告诉我 "Day 6 打卡",并贴出你的代码,我帮你检查。
明天预告(Day 7): 给 Todo 加分类、截止日期、统计、筛选,把它从玩具变成真正能用的工具。