# 新生导师分配系统

按签证、专业和沟通方式分组，再把结果整理成可以继续工作的 Excel

Source: https://works.im0o.top/projects/61b78776/
Date: 2025-03-31
Tags: Python, 数据分析, Excel, 开发工具


我为一个海外高校的新生导师项目写了这套分组脚本。输入是新生名单和导师名单，输出是工作人员可以继续核对、签到和补充的 Excel。分组要看国籍、沟通平台、签证状态和专业，导出的格式也跟着实际使用方式调整过。

## 先整理名单

新生来源里有 CSV，也有 Excel。我用 pandas 统一字段名，整理姓名、学号、专业、邮箱等信息，并根据来源和身份得到 Local、Granted、Pending 三种状态。

清洗时保留原始国籍字段用于判断中国大陆学生，再生成适合报表展示的国籍文本。已有入学名单可以用来排除重复记录，缺少国籍、缺少个人邮箱、已下签与待下签名单中重复的编号，也会汇总成提示。

导师名单同样要处理列名、常用名和组别，把 WX、WA 对应到微信与 WhatsApp 两类组。

## 分配时的顺序

待下签学生先从分配池中取出，另放 Pending 表。其余学生按国籍规则分到微信或 WhatsApp 池，再分别使用对应的导师组。

每个池内先按专业归类，从人数多的专业开始，按人数估算所需组数，再分配到这些组内。之后再平衡人数，从人数最多的组向最少的组移动学生，直到这一步的组间差距不超过一人。

最后按学生编号核对分配记录。发现遗漏时会输出提示，把这些学生补到该池的第一个导师组。清洗、分配和导出分别放在 loader、assigner、exporter 中，规则转换单独放在 rules，便于修改具体要求。

![待下签学生先留出，其余学生进入对应的沟通平台分组池](https://image.im0o.top/2026/20261117104333578.webp "待下签学生先留出，其余学生进入对应的沟通平台分组池")

## Excel 也是交付的一部分

结果除了组员名单，还有 Report、Mentor 和 Pending。微信、WhatsApp 两张分组表根据组号前缀命名，例如 AEP-WX、AEP-WA。

我在导出里安排了导师行、学生行、组内序号和 Attended 复选框。导师行用底色区分，每组后面留两行空白，工作人员可以在原表里补充。缺少国籍或邮箱的单元格标红，避免提示只留在命令行里。

Report 汇总新生、导师、组数和两种沟通平台的数量，也列出一名导师对应多组等需要核对的情况。Mentor 保留整理后的导师表，Pending 列出尚未进入分组的学生。

读取 Excel 使用 openpyxl，最终的样式、复选框和工作表由 XlsxWriter 写出。

![导师行、签到框和组后空行，让工作人员能接着使用导出的表](https://image.im0o.top/2026/20261117104340524.webp "导师行、签到框和组后空行，让工作人员能接着使用导出的表")

