跳到主要内容
CodeAtlas
Python · 语法与思维阶段 15 项必做

批量文件整理工具(按类型归档 + 重命名)

建立编程思维,能写 100 行内的实用脚本

难度
建议投入 24–42 小时· 5 条需求
验收权重
能独立写出带异常处理的脚本;理解可变与不可变对象40%
核心功能可独立跑通,无阻断性 bug25%
关键路径有测试或可复现的验收脚本15%
README 写清运行方式、架构与踩坑10%
能在 5 分钟内讲清设计与取舍10%

总分 100。低于 60 分说明这个阶段还没过,回去补知识点,不丢人。

项目背景

这是「Python」路径第 1 阶段(阶段一 · 语法与思维)的验收项目。本阶段目标是:建立编程思维,能写 100 行内的实用脚本。项目不是练习题的堆砌,而是把这一阶段的知识点压缩成一个能演示、能讲清楚取舍的成品。

MVP 目标
  • 建立编程思维,能写 100 行内的实用脚本
  • 做出可运行、可演示的「批量文件整理工具」
  • 把 变量/条件/循环/函数、列表/字典/集合/元组、文件读写与异常 真正用进项目,而不是停在笔记里

功能需求清单

5 项必做 · 0 项建议
  1. 1
    扫描与归档必做

    递归扫描目录,按扩展名归类到子目录。

  2. 2
    重名冲突必做

    同名文件自动加序号,不覆盖原文件。

  3. 3
    dry-run 预览必做

    先打印将要执行的操作,确认后再真正移动。

  4. 4
    日志与异常必做

    记录每次操作;单个文件失败不中断整体。

  5. 5
    命令行参数必做

    用 argparse 支持目录、目标目录、是否预览。

技术约束

变量/条件/循环/函数列表/字典/集合/元组文件读写与异常模块与包管理 venv/pip

交付物

  • Git 仓库(含分阶段提交记录,不是最后一次性上传)
  • README:项目简介、架构/流程图、运行方式、已知限制
  • 演示材料:截图,或 1–2 分钟录屏
  • 复盘:做错的 3 个决定与改进方案

加分项

  • 定时任务
  • 配置文件
  • 撤销上一次整理

最容易翻车的地方

  • 直接移动不做预览
  • 路径用字符串拼接而非 pathlib
  • 忽略隐藏文件与权限错误

做完之后,简历怎么写

「批量文件整理工具」:独立完成 按类型归档、重命名,使用 变量/条件/循环/函数、列表/字典/集合/元组、文件读写与异常;通过「能独立写出带异常处理的脚本」验收。

写「做了什么 + 用了什么 + 结果如何」,不要写「参与了 XX 系统」。