适合Python新手的3个入门实战项目:计算器与待办清单

方予
方予
发布时间:2026-11-22| 9人浏览过
原创

专为Python初学者设计的3个阶梯式实战项目:四则运算计算器、交互式内存待办清单以及支持JSON数据持久化的待办管理器。包含完整源码、逻辑图解与常见错误避坑指南。

掌握了变量、分支、循环和基础数据结构后,初学者常会陷入“语法看懂了却不知道怎么动手写程序”的困惑。解决这一瓶颈最直接的途径,是用有限的语法工具独立做出能交互、能执行、有反馈的轻量实用工具。本文围绕新手最易理解且结构清晰的两个经典场景——计算器与待办清单,拆解为3个难度逐级递进的实战项目:先用流程控制打造健壮的控制台计算器,再用列表与字典构建内存交互待办清单,最后引入文件模块实现数据持久化存储。所有示例基于标准Python环境,无需安装任何第三方库。

准备工作与环境说明

本文中的3个项目全部使用Python标准库完成,适配Python 3.6及以上任意版本(建议使用当前主流的Python 3.10或3.11)。在开始编写前,请确认本地已配置好Python环境。可以在终端(macOS/Linux下的Terminal,或Windows下的PowerShell/CMD)中运行以下指令核对版本:

python --version
# 或在部分系统中使用
python3 --version

建议为这几个练习新建一个独立的文件夹,例如命名为 python_starter_projects,并在其中按项目分别创建对应的 .py 脚本文件,便于独立运行与调试。

项目一:控制台四则运算计算器

计算器是检验基础逻辑控制的经典起点。一个合格的初级计算器不仅要能根据运算符完成加、减、乘、除运算,还必须具备持续运行的交互循环以及基础的输入容错能力,防止程序因输错一个字符或除数为零而瞬间崩溃。

1. 核心设计与执行流程

程序的核心逻辑包含四步:一是通过 while True 维持菜单循环;二是接收用户输入的数值与运算符,并用 float() 显式转换;三是通过 if-elif-else 分支执行对应的算术运算;四是处理异常输入与除以零的非法操作,并在每次运算后询问用户是否继续。

适合Python新手的3个入门实战项目:计算器与待办清单
图 1:计算器程序执行与异常防护逻辑流

2. 完整代码实现

在工程目录下创建 calculator.py,录入如下代码:

# calculator.py
def run_calculator():
    print("=" * 36)
    print("      简易控制台计算器 (Python版)")
    print("=" * 36)
    print("支持运算: + (加), - (减), * (乘), / (除)")
    print("随时输入 'q' 退出程序\n")

    while True:
      # 获取第一个数值
      user_input1 = input("请输入第一个数字 (或输入 q 退出): ").strip()
      if user_input1.lower() == 'q':
        print("计算器已退出。")
        break

      try:
        num1 = float(user_input1)
      except ValueError:
        print("【错误】输入的第一个值不是有效数字,请重新输入!\n")
        continue

      # 获取运算符
      operator = input("请输入运算符 (+, -, *, /): ").strip()
      if operator.lower() == 'q':
        print("计算器已退出。")
        break
      if operator not in ['+', '-', '*', '/']:
        print("【错误】不支持的运算符,仅支持 +, -, *, /\n")
        continue

      # 获取第二个数值
      user_input2 = input("请输入第二个数字: ").strip()
      if user_input2.lower() == 'q':
        print("计算器已退出。")
        break

      try:
        num2 = float(user_input2)
      except ValueError:
        print("【错误】输入的第二个值不是有效数字,请重新输入!\n")
        continue

      # 执行具体运算
      if operator == '+':
        result = num1 + num2
      elif operator == '-':
        result = num1 - num2
      elif operator == '*':
        result = num1 * num2
      elif operator == '/':
        if num2 == 0:
          print("【错误】除数不能为 0,无法进行除法运算!\n")
          continue
        result = num1 / num2

      # 规范输出:若结果是整数则不显示冗余的小数位
      if result.is_integer():
        display_result = int(result)
      else:
        display_result = round(result, 4)

      print(f">> 计算结果: {num1} {operator} {num2} = {display_result}\n")
      print("-" * 36)

if __name__ == "__main__":
    run_calculator()

3. 运行效果示例与要点提示

在终端中执行 python calculator.py,其典型交互如下:

[示例终端输出]
====================================
      简易控制台计算器 (Python版)
====================================
支持运算: + (加), - (减), * (乘), / (除)
随时输入 'q' 退出程序

请输入第一个数字 (或输入 q 退出): 12.5
请输入运算符 (+, -, *, /): *
请输入第二个数字: 4
>> 计算结果: 12.5 * 4.0 = 50
------------------------------------
请输入第一个数字 (或输入 q 退出): 8
请输入运算符 (+, -, *, /): /
请输入第二个数字: 0
【错误】除数不能为 0,无法进行除法运算!

新手易错点:input() 函数返回的内容永远是字符串(str)。如果不进行 float() 显式转换,直接执行 "12" + "34" 会得到拼接后的字符串 "1234" 而非数值相加。此外,使用 try-except ValueError 能够拦截用户意外敲击的英文字母,避免解释器抛出未捕获异常中断执行。

项目二:交互式命令行待办清单(内存版)

计算器主要锻炼单次计算和流程跳转,而待办清单(To-Do List)则带读者进入“数据集合组织”与“状态维护”的世界。新手需要学习如何在程序运行期间持久保存一组任务,并提供增、删、查、改的完整交互。

1. 内存数据模型设计

待办清单的核心是维护一个任务列表。在Python中,最自然的设计是用一个列表(list)作为容器,列表中的每一项用一个字典(dict)表示单条任务。每条任务包含文本内容与完成状态两个字段:

# 数据结构示例
tasks = [
    {"title": "完成Python计算器调试", "done": True},
    {"title": "阅读文件读写章节官方文档", "done": False}
]
适合Python新手的3个入门实战项目:计算器与待办清单
图 2:待办清单内存结构与指令操作机制

2. 完整代码实现

新建 todo_memory.py 文件,写入以下代码:

# todo_memory.py

def show_tasks(tasks):
    """展示当前所有待办任务"""
    print("\n--- 当前待办清单 ---")
    if not tasks:
      print("(暂无待办事项,输入 2 可添加新任务)")
      print("-" * 22)
      return

    for index, item in enumerate(tasks, start=1):
      status = "[✓] 已完成" if item["done"] else "[ ] 未完成"
      print(f"{index}. {status} - {item['title']}")
    print("-" * 22)

def add_task(tasks):
    """添加新任务"""
    title = input("请输入要添加的待办内容: ").strip()
    if not title:
      print("【提示】任务内容不能为空!")
      return
    tasks.append({"title": title, "done": False})
    print(f"成功添加任务: <{title}>")

def complete_task(tasks):
    """标记任务完成"""
    if not tasks:
      print("【提示】当前没有待办任务可标记。")
      return
    show_tasks(tasks)
    choice = input("请输入已完成的任务编号: ").strip()
    if not choice.isdigit():
      print("【错误】请输入有效的正整数序号!")
      return

    index = int(choice)
    if 1 <= index <= len(tasks):
      tasks[index - 1]["done"] = True
      print(f"已将第 {index} 个任务标记为完成!")
    else:
      print("【错误】输入的任务序号超出范围!")

def delete_task(tasks):
    """删除任务"""
    if not tasks:
      print("【提示】当前没有待办任务可删除。")
      return
    show_tasks(tasks)
    choice = input("请输入要删除的任务编号: ").strip()
    if not choice.isdigit():
      print("【错误】请输入有效的正整数序号!")
      return

    index = int(choice)
    if 1 <= index <= len(tasks):
      removed = tasks.pop(index - 1)
      print(f"已删除任务: <{removed['title']}>")
    else:
      print("【错误】输入的任务序号超出范围!")

def main():
    tasks = []  # 内存中的任务列表
    while True:
      print("\n===== 命令行待办清单管理器 =====")
      print("1. 查看待办列表")
      print("2. 添加待办事项")
      print("3. 标记任务为完成")
      print("4. 删除待办事项")
      print("5. 退出程序")
      choice = input("请选择操作 (1-5): ").strip()

      if choice == '1':
        show_tasks(tasks)
      elif choice == '2':
        add_task(tasks)
      elif choice == '3':
        complete_task(tasks)
      elif choice == '4':
        delete_task(tasks)
      elif choice == '5':
        print("感谢使用,程序已退出!")
        break
      else:
        print("【错误】无效的选择,请输入数字 1 到 5。")

if __name__ == "__main__":
    main()

3. 关键实现点解析

  • 显示序号与下标的转换:人类习惯从 1 开始计数,而 Python 列表的索引起始为 0。使用 enumerate(tasks, start=1) 可以直接在遍历中打印出 1、2、3……的序号;而在对列表取值时,必须通过 tasks[index - 1] 映射回物理下标。
  • 越界检查:在用户输入序号后,先用 choice.isdigit() 验证是否为纯数字,再通过 1 <= index <= len(tasks) 验证序号是否有效,能够彻底杜绝 IndexError 错误。
  • 函数模块化:将显示、添加、完成、删除分别封装为独立函数,主函数仅负责分支路由,代码结构非常清晰,极易复用与维护。

项目三:支持文件持久化的进阶待办清单

项目二的待办清单有一个明显的局限:所有数据保存在系统的内存中,一旦终端关闭或程序退出,之前添加的所有待办任务便荡然无存。真实软件开发中,状态必须被“持久化”保存到硬盘文件或数据库中。在项目三中,我们将引入 Python 标准库中的 json 和 os.path,把待办清单升级为一个真正具备实用价值的本地软件。

1. 持久化生命周期与读写逻辑

程序的生命周期被划分为三个阶段:启动时检查并反序列化加载本地数据、交互时按需读写内存、变更后序列化保存至本地磁盘文件。

适合Python新手的3个入门实战项目:计算器与待办清单
图 3:待办清单文件持久化(JSON)生命周期示意图

2. 完整代码实现

新建 todo_persistent.py 文件,完整代码如下:

# todo_persistent.py
import json
import os

# 定义数据存储的 JSON 文件路径
DATA_FILE = "todos.json"

def load_tasks():
    """从本地文件读取任务列表;若文件不存在或损坏则返回空列表"""
    if not os.path.exists(DATA_FILE):
      return []
    try:
      with open(DATA_FILE, "r", encoding="utf-8") as f:
        tasks = json.load(f)
        return tasks if isinstance(tasks, list) else []
    except (json.JSONDecodeError, IOError):
      print("【警告】读取数据文件出错,已恢复为空任务列表。")
      return []

def save_tasks(tasks):
    """将当前任务列表保存到本地 JSON 文件中"""
    try:
      with open(DATA_FILE, "w", encoding="utf-8") as f:
        # ensure_ascii=False 保证中文字符直接保存,indent=2 使文件格式清晰美观
        json.dump(tasks, f, ensure_ascii=False, indent=2)
    except IOError as e:
      print(f"【错误】写入文件失败: {e}")

def show_tasks(tasks):
    print("\n--- 任务清单 (本地存储已同步) ---")
    if not tasks:
      print("(当前没有任何待办事项)")
      print("-" * 32)
      return

    for index, item in enumerate(tasks, start=1):
      status = "[✓] 已完成" if item.get("done") else "[ ] 未完成"
      print(f"{index}. {status} - {item.get('title', '无标题')}")
    print("-" * 32)

def add_task(tasks):
    title = input("请输入要添加的待办内容: ").strip()
    if not title:
      print("【提示】任务内容不能为空!")
      return
    tasks.append({"title": title, "done": False})
    save_tasks(tasks)  # 即时落盘
    print(f"成功添加并保存: <{title}>")

def complete_task(tasks):
    if not tasks:
      print("【提示】当前没有待办任务。")
      return
    show_tasks(tasks)
    choice = input("请输入已完成的任务编号: ").strip()
    if not choice.isdigit():
      print("【错误】请输入有效数字编号!")
      return

    index = int(choice)
    if 1 <= index <= len(tasks):
      tasks[index - 1]["done"] = True
      save_tasks(tasks)  # 即时落盘
      print(f"已将第 {index} 个任务标记为完成!")
    else:
      print("【错误】序号超出范围!")

def delete_task(tasks):
    if not tasks:
      print("【提示】当前没有待办任务。")
      return
    show_tasks(tasks)
    choice = input("请输入要删除的任务编号: ").strip()
    if not choice.isdigit():
      print("【错误】请输入有效数字编号!")
      return

    index = int(choice)
    if 1 <= index <= len(tasks):
      removed = tasks.pop(index - 1)
      save_tasks(tasks)  # 即时落盘
      print(f"已删除任务: <{removed['title']}>")
    else:
      print("【错误】序号超出范围!")

def main():
    tasks = load_tasks()
    print(f"系统启动成功,从 {DATA_FILE} 恢复了 {len(tasks)} 条历史任务。")

    while True:
      print("\n===== 待办清单管理器 (持久化版本) =====")
      print("1. 查看任务列表")
      print("2. 新增待办事项")
      print("3. 标记任务完成")
      print("4. 删除待办事项")
      print("5. 退出程序")
      choice = input("请选择操作 (1-5): ").strip()

      if choice == '1':
        show_tasks(tasks)
      elif choice == '2':
        add_task(tasks)
      elif choice == '3':
        complete_task(tasks)
      elif choice == '4':
        delete_task(tasks)
      elif choice == '5':
        print("所有数据已安全持久化,程序退出。")
        break
      else:
        print("【错误】请输入 1-5 之间的数字。")

if __name__ == "__main__":
    main()

3. 持久化数据文件结构与查看

在添加两条任务并标记其中一条完成后,程序会在同级目录下自动生成 todos.json。可以用任意文本编辑器打开查看其内容,结构如下:

[
  {
    "title": "完成计算器与待办清单代码编写",
    "done": true
  },
  {
    "title": "测试文件读写异常恢复机制",
    "done": false
  }
]

退出程序后重新运行 python todo_persistent.py,终端会提示 系统启动成功,从 todos.json 恢复了 2 条历史任务,并且输入 1 可以立刻看到之前的数据,真正达到了实用桌面小工具的标准。

3个入门项目的知识进阶复盘

这三个实战项目并非孤立的代码练习,而是一套高度契合新手认知规律的循序渐进路线图。从单一变量计算,到数据集合操作,再到文件持久化与系统工程思维,初学者在不知不觉中完成了从“背诵语法”到“构建程序”的转变。

适合Python新手的3个入门实战项目:计算器与待办清单
图 4:3个入门实战项目的核心知识演进图谱
项目名称 核心运用知识点 典型应用场景 给新手的避坑建议
控制台四则计算器 input()、float()、if-elif-else、while True、try-except 单次及循环数学计算、参数解析校验 必须将输入字符串转换为数值类型;必须主动防范除数为零与非法字符。
交互式待办清单(内存版) 列表 list、字典 dict、enumerate()、append()、pop() 会话期数据集合管理、命令行菜单分发 用户输入的是序号(从1开始),列表下标从0开始;删除或修改前务必校验索引边界。
持久化待办清单(文件版) with open()、json.load()、json.dump()、os.path.exists() 本地配置读写、离线状态存储、轻量应用开发 必须显式指定 encoding='utf-8' 与 ensure_ascii=False,避免跨平台中文字符乱码。

新手进阶扩展建议

在熟练运行并理解上述三个项目的代码后,读者还可以尝试在此基础上进行以下功能的自主扩展:

  1. 为待办清单增加优先级与截止日期字段:在任务字典中增加 "priority": "高" 或 "due_date": "2026-10-30",并在展示时一并列出。
  2. 支持任务描述修改功能:新增一个菜单项(例如输入 6),允许用户输入任务编号并更新其文字描述。
  3. 按状态筛选展示:分别提供“只看未完成”与“只看已完成”的筛选视图,深化对列表推导式(List Comprehension)的掌握。
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。