适合Python新手的3个入门实战项目:计算器与待办清单
专为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 分支执行对应的算术运算;四是处理异常输入与除以零的非法操作,并在每次运算后询问用户是否继续。
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}
]
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. 持久化生命周期与读写逻辑
程序的生命周期被划分为三个阶段:启动时检查并反序列化加载本地数据、交互时按需读写内存、变更后序列化保存至本地磁盘文件。
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个入门项目的知识进阶复盘
这三个实战项目并非孤立的代码练习,而是一套高度契合新手认知规律的循序渐进路线图。从单一变量计算,到数据集合操作,再到文件持久化与系统工程思维,初学者在不知不觉中完成了从“背诵语法”到“构建程序”的转变。
| 项目名称 | 核心运用知识点 | 典型应用场景 | 给新手的避坑建议 |
|---|---|---|---|
| 控制台四则计算器 | 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,避免跨平台中文字符乱码。 |
新手进阶扩展建议
在熟练运行并理解上述三个项目的代码后,读者还可以尝试在此基础上进行以下功能的自主扩展:
- 为待办清单增加优先级与截止日期字段:在任务字典中增加
"priority": "高"或"due_date": "2026-10-30",并在展示时一并列出。 - 支持任务描述修改功能:新增一个菜单项(例如输入
6),允许用户输入任务编号并更新其文字描述。 - 按状态筛选展示:分别提供“只看未完成”与“只看已完成”的筛选视图,深化对列表推导式(List Comprehension)的掌握。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









