原文链接

01_程序要求

  • 程序启动，显示名片管理系统欢迎界面，并显示功能菜单
  • 用户用数字选择不同的功能
  • 根据功能选择，执行不同的功能
  • 用户名片需要记录用户的 姓名、性别、年龄
  • 如果查询到指定的名片，用户可以选择 修改 或者 删除 名片

02_步骤

框架搭建

  • 准备文件，确定文件名，保证能够 在需要的位置 编写代码
  • 编写 主运行循环，实现基本的 用户输入和判断

文件准备

  • 新建 cards_main.py 保存 主程序功能代码
    i.程序的入口
    ii.每一次启动名片管理系统都通过 main 这个文件启动

  • 新建 cards_tools.py 保存 所有名片功能函数
    将对名片的 新增、查询、修改、删除 等功能封装在不同的函数中

编写主运行循环

  • 在 cards_main 中添加一个 无限循环
  1. while True:
  3.     # TODO(小明) 显示系统菜单
  5.     # 根据用户输入决定后续的操作
  6.      if num == 1:  # 新建名片
  7.         pass
  9.     elif num == 2:  # 显示全部
  10.         pass
  12.     elif num == 3:  # 查询名片
  13.         pass
  15.     elif num == 0:
  16.         break
  18.      else:
  19.          print("输入错误，请重新输入")
  • pass 就是一个空语句，不做任何事情，一般用做占位语句，是为了保持程序结构的完整性
  • 在开发软件时，如果 不希望程序执行后 立即退出，可以在程序中增加一个 无限循环，由用户来决定 退出程序的时机
  • 在 # 后跟上 TODO，用于标记需要去做的工作
  • 在界面左下角的图表中，选择 TODO ，并找到文件夹下的程序，点击 TODO ，能快速定位到标记的位置

在 cards_tools 中增加四个新函数

  1. def show_menu():
  3.     """显示菜单
  4.     """
  5.     pass
  7. def new_card():
  8.     print("-" * 50)
  9.     print("功能：新建名片")
  12. def show_all():
  13.     print("-" * 50)
  14.     print("功能：显示全部")
  17. def search_card():
  18.     print("-" * 50)
  19.     print("功能：搜索名片")

导入模块

  • 在 cards_main.py 中使用 import 导入 cards_tools 模块
  1. import cards_tools
  • 修改 while 循环的代码如下：
  1. while True:
  2.     num = cards_tools.show_menu()
  3.     if num == 1:  # 新建名片
  4.         cards_tools.new_card(cards_list)
  6.     elif num == 2:  # 显示全部
  7.         cards_tools.show_all(cards_list)
  9.     elif num == 3:  # 查询名片
  10.         cards_tools.search_card(cards_list)
  12.     elif num == 0:
  13.         print("欢迎再次使用【名片管理系统】")
  14.         break
  16.      else:
  17.          print("输入错误，请重新输入")

完成 show_menu 函数

  1. def show_menu():
  2.     oper_tuple = ("退出系统", "新建名片", "显示全部", "查询名片")
  4.     print("*" * 50)
  5.     print("欢迎使用【名片管理系统】V1.0\n")
  6.     print("1.新建名片")
  7.     print("2.显示全部")
  8.     print("3.查询名片\n")
  9.     print("0.退出系统")
  10.     print("*" * 50)
  12.     num_str = input("请选择操作功能：")
  13.     if num_str not in ["0", "1", "2", "3"]:  # 如果输入的不在选项中
  14.         print("输入错误，请重新输入")
  15.         return
  16.     num = int(num_str)
  18.     print("你选择的操作是：%d" % num)
  19.     print('-' * 50)
  20.     print("功能：%s" % oper_tuple[num])
  21.     return num

保存名片数据的结构

  • 程序就是用来处理数据的，而变量就是用来存储数据的
  • 使用 字典 记录 每一张名片 的详细信息
  • 使用 列表 统一记录所有的 名片字典
  • 在 cards_main 文件的顶部增加一个 列表变量
  1. # 所有名片记录的列表
  2. card_list = []

i.所有名片相关操作，都需要使用这个列表，所以应该 定义在程序的顶部
ii.程序刚运行时，没有数据，所以是 空列表

新增名片

功能分析

  • 提示用户依次输入名片信息
  • 将名片信息保存到一个字典
  • 将字典添加到名片列表
  • 提示名片添加完成

根据步骤实现代码

  1. def new_card(cards_list):  # 新增名片
  2.     print("新增名片")
  4.     name_str = input("请输入姓名:")
  5.     gender_str = input("请输入性别：")
  6.     age_str = input("请输入年龄：")
  8.     # 使用用户输入的信息建立一个名片字典
  9.     cards_dict = {"name": name_str,
  10.                   "gender": gender_str,
  11.                   "age": age_str}
  13.     # 将名片字典添加到列表中
  14.     cards_list.append(cards_dict)
  16.     print("成功增加 %s 的名片" % name_str)
  • 右键选中变量，点击 Refactor 中的 Rename，能批量修改变量名，以回车键结束

显示所有名片

功能分析

  • 循环遍历名片列表，顺序显示每一个字典的信息

代码实现

  1. def show_all(cards_list):  # 显示所有名片
  2.     # 判断是否存在名片记录
  3.     if len(cards_list) == 0:
  4.         print("提示：没有任何名片信息")
  5.         return
  7.     # 打印表表头信息
  8.     for k in ["姓名", "性别", "年龄"]:
  9.         print("%s" % k, end="\t\t")
  10.     print(" ")
  11.     print("-" * 50)
  13.     # 遍历名片列表依次输出字典信息
  14.     for cards in cards_list:
  15.         # print("%s\t\t%s\t\t%s\t\t" % (cards["name"], cards["gender"], cards["age"]))
  16.         for k in [cards["name"], cards["gender"], cards["age"]]:
  17.             print("%s" % k.ljust(8, " "), end="")
  18.         print(" ")
  19.     print("-" * 50)
  • 在函数中使用 return 表示返回
  • 如果在 return 后没有跟任何内容，只是表示该函数执行到此就不再执行后续的代码

查询名片

功能分析

  • 提示用户要搜索的姓名
  • 根据用户输入的姓名遍历列表
  • 搜索到指定的名片后，再执行后续的操作

代码实现

  • 搜索名片
  1. def search_card(cards_list):  # 搜索名片
  3.     find_name = input("请输入要搜索的姓名：")
  5.     count = -1
  6.     for find in cards_list:        
  7.         count += 1   # 记录搜索到的姓名的索引，便于后续对名片的操作
  8.         if find_name == find["name"]:
  9.             for k in ["姓名", "性别", "年龄"]:
  10.                 print("%s" % k, end="\t\t")
  11.             print(" ")
  12.             print("-" * 50)
  13.             for k in [find["name"], find["gender"], find["age"]]:
  14.                 print("%s" % k.ljust(8, " "), end="")
  15.             print(" ")
  16.             print("-" * 50)
  18.             deal_cards(count, find, cards_list)
  19.             return
  21.     print("抱歉没有找到 %s,请重新输入" % find_name)
  • 处理名片
  1. def deal_cards(count, find, cards_list):  # 处理名片
  2.     action = input("请输入对名片的操作：1：修改/ 2:删除/ 0:返回上级菜单:")
  3.     while True:
  4.         if action == "1":
  5.             # 如果用户没有输入内容，返回字典原有的值
  6.             name_str = input("请输入姓名 [回车不修改]：")
  7.             if name_str == "":
  8.                 name_str = find["name"]
  10.             gender_str = input("请输入性别 [回车不修改]：")
  11.             if gender_str == "":
  12.                 gender_str = find["gender"]
  14.             age_str = input("请输入年龄 [回车不修改]：")
  15.             if age_str == "":
  16.                 age_str = find["age"]
  18.             find = {"name": name_str,
  19.                     "gender": gender_str,
  20.                     "age": age_str}
  22.             print("%s 的名片修改成功" % find["name"])
  23.             cards_list[count] = find
  25.         elif action == "2":
  26.             cards_list.remove(find)
  27.             print("你已成功删除 %s 的信息" % find["name"])
  28.             return
  30.         elif action == "0":
  31.             return
  33.         else:
  34.             action = input("输入错误，请重新输入 1：修改/ 2:删除/ 0:返回上级菜单:")
  • 由于找到的字典记录已经在列表中保存
  • 要删除名片记录，只需要把列表中对应的字典删除即可
  • 要修改名片记录，只需要把列表中对应的字典中每一个键值对的数据修改即可

03_完整代码

cards_main.py文件

  1. import cards_tools
  2. cards_list = []
  4. # TODO 需要做的事
  5. while True:
  6.     num = cards_tools.show_menu()
  7.     if num == 1:  # 新建名片
  8.         cards_tools.new_card(cards_list)
  10.     elif num == 2:  # 显示全部
  11.         cards_tools.show_all(cards_list)
  13.     elif num == 3:  # 查询名片
  14.         cards_tools.search_card(cards_list)
  16.     elif num == 0:
  17.         print("欢迎再次使用【名片管理系统】")
  18.         break

cards_tools.py文件

  1. def show_menu():
  2.     oper_tuple = ("退出系统", "新建名片", "显示全部", "查询名片")
  4.     print("*" * 50)
  5.     print("欢迎使用【名片管理系统】V1.0\n")
  6.     print("1.新建名片")
  7.     print("2.显示全部")
  8.     print("3.查询名片\n")
  9.     print("0.退出系统")
  10.     print("*" * 50)
  12.     num_str = input("请选择操作功能：")
  13.     if num_str not in ["0", "1", "2", "3"]:  # 如果输入的不在选项中
  14.         print("输入错误，请重新输入")
  15.         return
  16.     num = int(num_str)
  18.     print("你选择的操作是：%d" % num)
  19.     print('-' * 50)
  20.     print("功能：%s" % oper_tuple[num])
  21.     return num
  24. def new_card(cards_list):  # 新增名片
  25.     print("新增名片")
  27.     name_str = input("请输入姓名:")
  28.     gender_str = input("请输入性别：")
  29.     age_str = input("请输入年龄：")
  31.     # 使用用户输入的信息建立一个名片字典
  32.     cards_dict = {"name": name_str,
  33.                   "gender": gender_str,
  34.                   "age": age_str}
  36.     # 将名片字典添加到列表中
  37.     cards_list.append(cards_dict)
  39.     print("成功增加 %s 的名片" % name_str)
  42. def show_all(cards_list):  # 显示所有名片
  43.     # 判断是否存在名片记录
  44.     if len(cards_list) == 0:
  45.         print("提示：没有任何名片信息")
  46.         return
  47.     # 打印表表头信息
  48.     for k in ["姓名", "性别", "年龄"]:
  49.         print("%s" % k, end="\t\t")
  50.     print(" ")
  51.     print("-" * 50)
  53.     # 遍历名片列表依次输出字典信息
  54.     for cards in cards_list:
  55.         # print("%s\t\t%s\t\t%s\t\t" % (cards["name"], cards["gender"], cards["age"]))
  56.         for k in [cards["name"], cards["gender"], cards["age"]]:
  57.             print("%s" % k.ljust(8, " "), end="")
  58.         print(" ")
  59.     print("-" * 50)
  62. def search_card(cards_list):  # 搜索名片
  64.     find_name = input("请输入要搜索的姓名：")
  66.     count = -1
  67.     for find in cards_list:
  68.         count += 1   # 记录搜索到的姓名的索引，便于后续对名片的操作
  69.         if find_name == find["name"]:
  70.             for k in ["姓名", "性别", "年龄"]:
  71.                 print("%s" % k, end="\t\t")
  72.             print(" ")
  73.             print("-" * 50)
  74.             for k in [find["name"], find["gender"], find["age"]]:
  75.                 print("%s" % k.ljust(8, " "), end="")
  76.             print(" ")
  77.             print("-" * 50)
  79.             deal_cards(count, find, cards_list)
  80.             return
  82.     print("抱歉没有找到 %s,请重新输入" % find_name)
  85. def deal_cards(count, find, cards_list):  # 处理名片
  86.     action = input("请输入对名片的操作：1：修改/ 2:删除/ 0:返回上级菜单:")
  87.     while True:
  88.         if action == "1":
  89.             # 如果用户没有输入内容，返回字典原有的值
  90.             name_str = input("请输入姓名 [回车不修改]：")
  91.             if name_str == "":
  92.                 name_str = find["name"]
  94.             gender_str = input("请输入性别 [回车不修改]：")
  95.             if gender_str == "":
  96.                 gender_str = find["gender"]
  98.             age_str = input("请输入年龄 [回车不修改]：")
  99.             if age_str == "":
  100.                 age_str = find["age"]
  102.             find = {"name": name_str,
  103.                     "gender": gender_str,
  104.                     "age": age_str}
  106.             print("%s 的名片修改成功" % find["name"])
  107.             cards_list[count] = find
  109.         elif action == "2":
  110.             cards_list.remove(find)
  111.             print("你已成功删除 %s 的信息" % find["name"])
  112.             return
  114.         elif action == "0":
  115.             return
  117.         else:
  118.             action = input("输入错误，请重新输入 1：修改/ 2:删除/ 0:返回上级菜单:")