python程序源码_小游戏、工具脚本到Web系统的可学习程序集锦
初学者应通过可运行、可修改、可拆解的真实小项目提升实战能力：从终端小游戏（如猜数字）练输入处理与状态管理，到命令行工具（如批量重命名）学参数解析与文件操作，再到轻量Web接口（Flask健康检查与求和）掌握路由与请求解析，最后理解import路径机制避免模块导入错误。
Python 初学者常卡在“学完语法却不知道能做什么”，其实关键不是找“最全合集”，而是找到一批能跑、能改、能拆解的真实小项目——它们得有明确输入输出、不依赖黑盒框架、代码量控制在 200 行内，且每个都暴露一个典型技术点。
从终端小游戏开始：理解事件循环与状态管理
别一上来就写贪吃蛇完整版。先用 input() + while True: 实现一个“猜数字”或“石头剪刀布”，重点练三件事：如何把用户输入转成预期类型（int(input()) 可能抛 ValueError）、怎么用布尔变量控制游戏是否继续（game_running = False）、为什么不能把所有逻辑塞进一个函数里（比如验证输入和判断胜负最好拆开）。
常见坑：input() 返回永远是字符串，"5" != 5；用 random.randint(1, 10) 时误写成 random.random(1, 10)（后者报错）；忘记在循环末尾加 continue 或 break 导致死循环。
命令行工具脚本：学会读取参数与处理文件
写一个 rename.py：接收目录路径和前缀，批量给该目录下所有 .txt 文件重命名（如 old.txt → prefix_old.txt）。核心就三步：sys.argv 拿命令行参数、os.listdir() 或 pathlib.Path().glob("*.txt") 扫文件、os.rename() 或 Path.rename() 改名。
必须加的防护：if not os.path.isdir(sys.argv[1]): 防止路径不存在；用 shutil.move() 替代 os.rename() 更安全（跨分区也能用）；重命名前用 print(f"Will rename {old} → {new}") 先预览，别直接执行。
性能提示：pathlib 写法更现代（Path("data").glob("*.log")），但老服务器可能只有 Python 3.4，得 fallback 到 os.listdir() + 字符串匹配。
轻量 Web 接口：用 Flask 暴露一个真实可用的端点
不要碰模板、数据库、用户登录。只写一个 app.py：启动后访问 http://127.0.0.1:5000/health 返回 {"status": "ok", "timestamp": 171xxxxxx}；访问 /sum?a=2&b=3 返回 {"result": 5}。代码不超过 30 行，只用 Flask 和 request.args.get()。
关键细节：a 和 b 是字符串，必须 int(request.args.get("a", 0)) 转型，否则 "2" + "3" == "23"；加 @app.route("/health") 时别漏掉斜杠；调试时设 debug=True，但上线前必须关掉（会暴露 traceback）。
兼容性注意：Flask 2.3+ 默认禁用 ENV 和 DEBUG 环境变量，得显式传参 app.run(debug=True)，否则本地也启动不了。
别急着封装成包：先搞懂 import 的实际路径行为
很多人把一堆 .py 文件扔进文件夹就 import utils，结果报 ModuleNotFoundError。真实情况是：import 只查 sys.path 里的路径，而当前目录（""）默认在第一位——所以必须从项目根目录运行脚本，而不是在子目录里 python tools/clean.py。
简单解法只有两个：export PYTHONPATH=$(pwd)（Linux/macOS）或临时改 sys.path.insert(0, "..")；更可持续的做法是用 -m 参数运行：python -m tools.clean，前提是目录含 __main__.py。
容易被忽略的点：from . import xxx 是相对导入，只能用在模块内部（即通过 -m 运行），直接 python xxx.py 会报 SystemError: Parent module '' not loaded。