简介：这份成绩登记表文档面向中小学教师、班主任及教务管理人员，用于日常记录与管理班级学生的语文学习成绩，也可作为数据库设计、信息系统入门学习的参考素材。资源包共1个doc文件，约153KB，内容以表格形式呈现，涵盖学号、姓名、平时成绩、期中效果、期末效果、学期评分、合计与平均分等字段，可直接打印或二次编辑使用。文档结构清晰，字段划分明确，便于按学生逐条登记与统计，也能帮助读者理解成绩数据从采集、存储到分析的基本流程，为后续成绩统计、教学质量评估提供基础数据支撑。目前已有100人学习下载，适合需要快速搭建成绩记录模板或研究简单数据表设计的用户参考使用。
1. 成绩登记表(2).doc 背后的真实需求：从一份“野生表格”到可复现的数据管道
带过毕业设计或者做过教务系统对接的工程师，大概率都遇到过这种文件：成绩登记表(2).doc。文件名里的(2)是血泪经验——它意味着前面已经有过一版，可能是格式被改乱了，可能是数据对不上，也可能是导师或教务又提了新要求。这个标题看着像一份普通文档，但它背后藏着一个非常典型的工程问题：如何把一份格式不固定、来源不可控的 Word 成绩表，稳定地解析成结构化数据，并且能重复跑、能校验、能追溯。
它适合谁？适合正在做教务数据迁移、毕业设计管理系统、成绩分析看板，或者任何需要从 Word 文档里批量提取表格数据的人。核心痛点不是“读 Word”本身，而是 Word 表格的合并单元格、空行、跨页断行、手动换行符这些玄学问题，会让一个看似简单的解析脚本在真实文件上集体翻车。这篇笔记就按我实际处理这类文件的路径，从选型、解析、清洗到校验，把每一步的参数和坑讲清楚。
2. 解析 .doc 成绩表的选型：为什么不能直接上 python-docx
2.1 .doc 与 .docx 的格式分水岭
很多人拿到成绩登记表(2).doc第一反应是pip install python-docx，然后发现报错Package not found或者读出来是空。原因很简单：python-docx只认 OOXML 格式，也就是.docx。而.doc是微软 97-2003 的二进制复合文档格式，底层是 OLE 结构，两者完全不是一回事。
常见做法是先用 LibreOffice 做一次无头转换，把.doc转成.docx，再交给python-docx处理。这个转换步骤在 Linux 服务器上也能跑，不需要装 Office。命令如下：
# 无头模式转换，--headless 不弹界面，--convert-to 指定目标格式 libreoffice --headless --convert-to docx --outdir ./converted "成绩登记表(2).doc"逻辑说明：--headless让 LibreOffice 以服务方式运行，适合放在自动化脚本里；--outdir指定输出目录，避免污染原目录。参数上唯一需要注意的是，如果服务器上同时跑了多个转换任务，LibreOffice 的用户配置目录会冲突，建议给每个任务指定独立的-env:UserInstallation参数。
转换完成后，./converted/成绩登记表(2).docx就可以被python-docx正常读取了。这一步的翻车点在于：有些.doc文件本身已经损坏，LibreOffice 会静默失败，输出一个 0 字节的 docx。所以转换后必须检查文件大小，小于 1KB 的直接标记为异常。
2.2 读取表格的最小可用代码
拿到.docx之后，读取表格的核心代码其实很短，但参数和边界处理才是重点：
from docx import Document doc = Document("./converted/成绩登记表(2).docx") # 遍历所有表格，doc.tables 是一个列表 for t_idx, table in enumerate(doc.tables): print(f"=== 表格 {t_idx}，行数 {len(table.rows)}，列数 {len(table.columns)} ===") for r_idx, row in enumerate(table.rows): # cell.text 会保留手动换行符 \n，需要后续清洗 cells = [cell.text.strip() for cell in row.cells] print(r_idx, cells)逻辑说明：doc.tables返回文档中所有表格对象，顺序与文档中出现的顺序一致。row.cells在遇到合并单元格时会返回重复的 cell 对象，这是后面去重逻辑要处理的核心问题。参数上，cell.text拿到的是纯文本，但会保留 Word 里的手动换行符（\n）和多余空格，所以.strip()只是第一步，后面还要做更细的清洗。
提示：如果文档里表格是嵌套的，
doc.tables只返回顶层表格，嵌套表格需要遍历 cell 内部的cell.tables。成绩登记表一般不会嵌套，但遇到教务系统导出的复杂模板时要留意。
3. 成绩表格清洗：合并单元格、空行与学号校验的实战处理
3.1 合并单元格的去重与填充
Word 表格的合并单元格在python-docx里表现为：同一行中多个列返回同一个 cell 对象，或者同一列中多个行返回同一个 cell 对象。直接按行列索引取值，会得到大量重复数据。处理策略是：先按 cell 对象的_tc属性（底层 XML 元素）做唯一性判断，再决定是横向合并还是纵向合并。
def dedupe_row(row): """对一行内的合并单元格做去重，保留第一个出现的值""" seen = set() result = [] for cell in row.cells: tc_id = id(cell._tc) # 用底层 XML 元素 id 判断是否同一个 cell if tc_id not in seen: seen.add(tc_id) result.append(cell.text.strip()) else: result.append("") # 重复位置填空，保持列对齐 return result逻辑说明：cell._tc是 python-docx 内部指向 XML 元素的引用，同一个合并单元格在不同行列位置返回的_tc是同一个对象，所以用id()可以判断重复。参数上，重复位置填""而不是直接跳过，是为了保持后续按列索引取值的稳定性——如果直接跳过，列数会变，后面按row[3]取学号就会错位。
纵向合并的处理类似，但需要在列方向上做一次扫描，把空白单元格用上方最近的非空值填充。这一步在成绩表里很常见，比如“班级”列合并后，只有第一行有值，下面全是空。
3.2 学号与成绩的格式校验
清洗完结构之后，下一步是字段级校验。成绩登记表里最容易出问题的三个字段是：学号、姓名、成绩。学号通常是 8 到 12 位数字，但 Word 里经常被存成文本后带上了不可见字符；姓名可能有空格；成绩可能是“优秀”“良好”这种等级制，也可能是数字但带了“分”字。
import re def clean_student_id(raw): """提取纯数字学号，去掉所有非数字字符""" digits = re.sub(r"\D", "", raw) if 8 <= len(digits) <= 12: return digits return None # 长度不对，标记为异常 def clean_score(raw): """把成绩统一成 float，等级制返回 None 并单独记录""" raw = raw.strip().replace("分", "") try: score = float(raw) if 0 <= score <= 100: return score except ValueError: pass return None # 等级制或异常值逻辑说明：re.sub(r"\D", "", raw)把所有非数字字符干掉，能处理“2021 001234”这种带空格的学号。参数上，学号长度限制在 8 到 12 位是常见教务系统的约束，如果你们学校是 10 位，改成10 <= len(digits) <= 10即可。成绩校验里，0 <= score <= 100是硬边界，超出范围的直接标记异常，不要静默截断——截断会让原始数据失真，后面查都查不回来。
注意：等级制成绩（优秀/良好/中等/及格/不及格）不要强行映射成数字，除非教务明确给了映射规则。我一般会单独存一列
score_type，标记是数字还是等级，后续分析时再决定怎么处理。
3.3 空行与跨页断行的识别
Word 表格里经常夹杂空行，尤其是从 PDF 转过来或者手动调整过格式的文件。空行的特征是：整行所有 cell 的text.strip()都为空。但要注意，有些行看起来空，实际上某个 cell 里有一个空格或换行符，所以判断条件要用strip()之后的结果。
跨页断行是另一个坑：Word 在分页处会把一行拆成两行显示，但底层 XML 里可能还是同一行，也可能真的变成了两行。判断方法是看学号列——如果某行学号为空但其他列有值，很可能是上一行的续行。处理策略是：遇到学号为空且姓名也为空的行，直接跳过；遇到学号为空但姓名或成绩有值的行，向上合并到最近的有效行。
def is_empty_row(cells): """判断是否为空行：所有单元格 strip 后都为空""" return all(c.strip() == "" for c in cells) def merge_continuation(rows): """把续行合并到上一行：学号为空但其他列有值时触发""" merged = [] for row in rows: if merged and not row[0] and any(row[1:]): # 学号列为空，但姓名或成绩有值，合并到上一行 for i in range(1, len(row)): if row[i]: merged[-1][i] = (merged[-1][i] + " " + row[i]).strip() else: merged.append(row) return merged逻辑说明：merge_continuation的核心判断是not row[0] and any(row[1:])，即学号列为空但其他列有内容。合并时用空格拼接，避免姓名被截断。参数上，如果你的表格学号不在第一列，把索引0改成实际列号即可。
4. 批量处理与输出：从单文件到目录级管道的工程化
4.1 目录扫描与文件过滤
实际场景里不会只有一个成绩登记表(2).doc，而是一个目录下几十个类似文件，命名可能是成绩登记表(1).doc、成绩登记表(3).doc、XX班成绩.doc。批量处理的第一步是过滤出真正的 Word 文件，排除临时文件（~$开头）和已经转换过的文件。
import os from pathlib import Path def scan_doc_files(root_dir): """扫描目录下所有 .doc 文件，排除临时文件和已转换的""" doc_files = [] for p in Path(root_dir).rglob("*.doc"): # 排除 Word 临时文件（~$ 开头）和已转换的 docx if p.name.startswith("~$"): continue doc_files.append(p) return sorted(doc_files)逻辑说明：rglob("*.doc")会递归扫描子目录，适合按班级分文件夹存放的场景。排除~$开头的文件是因为 Word 打开文档时会生成临时文件，这些文件不是真实数据。参数上，sorted()保证处理顺序稳定，方便复现和对比结果。
4.2 转换、解析、清洗的串联管道
把前面的步骤串起来，形成一个可重复执行的管道。每个文件独立处理，单个文件失败不影响其他文件，失败信息记录到日志里。
import subprocess import json from datetime import datetime def process_one_doc(doc_path, output_dir): """处理单个 .doc 文件：转换 -> 解析 -> 清洗 -> 输出 JSON""" result = {"file": str(doc_path), "status": "ok", "rows": [], "errors": []} # 步骤1：转换 converted = Path(output_dir) / (doc_path.stem + ".docx") cmd = ["libreoffice", "--headless", "--convert-to", "docx", "--outdir", str(output_dir), str(doc_path)] subprocess.run(cmd, capture_output=True, timeout=60) if not converted.exists() or converted.stat().st_size < 1024: result["status"] = "convert_failed" result["errors"].append("转换后文件不存在或过小") return result # 步骤2：解析表格 doc = Document(str(converted)) if not doc.tables: result["status"] = "no_table" result["errors"].append("文档中未找到表格") return result table = doc.tables[0] # 默认取第一个表格 raw_rows = [dedupe_row(row) for row in table.rows] # 步骤3：清洗 cleaned = [] for row in raw_rows: if is_empty_row(row): continue sid = clean_student_id(row[0]) if row else None if sid is None: result["errors"].append(f"学号异常: {row[:3]}") continue cleaned.append({ "student_id": sid, "name": row[1].strip() if len(row) > 1 else "", "score": clean_score(row[2]) if len(row) > 2 else None, }) result["rows"] = cleaned return result逻辑说明：subprocess.run调用 LibreOffice 转换，timeout=60防止某个损坏文件卡死整个管道。转换后检查文件大小，小于 1KB 视为失败。解析时默认取第一个表格，如果文档里有多个表格，需要根据表头内容判断哪个是成绩表。清洗阶段，学号异常的记录到errors里但不中断，保证其他行能正常输出。
参数上，output_dir建议按日期分目录，比如./output/20250101/，这样每次跑的结果不会互相覆盖，方便回溯。输出格式用 JSON 而不是 CSV，是因为 JSON 能保留嵌套结构和错误信息，后续导入数据库或做分析都更方便。
4.3 输出结果的结构化存储
最终输出建议用 JSON Lines 格式，每行一个文件的结果，方便用jq或 pandas 直接读取：
def save_results(results, output_path): """把处理结果写成 JSON Lines，每行一个文件""" with open(output_path, "w", encoding="utf-8") as f: for r in results: f.write(json.dumps(r, ensure_ascii=False) + "\n")逻辑说明：ensure_ascii=False保证中文姓名正常显示，不会被转成\uXXXX。JSON Lines 的好处是追加写入方便，处理到一半中断了也不会丢失已完成的结果。参数上，如果后续要用 pandas 分析，直接pd.read_json(output_path, lines=True)即可。
5. 避坑与排查：成绩登记表解析中最容易翻车的 5 个点
5.1 转换后表格结构错乱
现象：.doc转成.docx后，原本 5 列的表格变成了 8 列，或者合并单元格全部散开。
原因：LibreOffice 对某些老版本 Word 的表格布局兼容性不好，尤其是用了“自动调整”和“固定列宽”混排的表格。
解决：换用--convert-to docx:"MS Word 2007 XML"指定输出格式，或者先用 Word 手动另存为.docx再处理。如果文件量不大，手动另存是最稳的。批量场景下，可以在转换后加一步列数校验：如果列数超过预期，标记为异常人工介入。
5.2 学号被识别成科学计数法
现象：学号202100123456在 Word 里显示正常，但读出来变成2.02100123456e+11。
原因：Word 表格里学号被存成了数字格式，python-docx读取时按浮点数处理。
解决：在clean_student_id里先判断原始文本是否包含e或E，如果是，用Decimal还原：
from decimal import Decimal def restore_scientific(raw): """还原被科学计数法表示的学号""" if "e" in raw.lower(): return str(Decimal(raw).to_integral_value()) return raw参数上，Decimal比float精度高，能准确还原 12 位以内的学号。超过 15 位的数字Decimal也会丢精度，但学号一般不会那么长。
5.3 姓名中的生僻字变成方框
现象：解析出来的姓名里，生僻字显示为□或乱码。
原因：.doc文件用的字体不支持生僻字，或者转换过程中编码丢失。
解决：这种情况在源文件层面就丢了信息，解析阶段无法恢复。处理策略是标记出来，让业务方对照原始文件人工补录。可以在输出里加一个name_has_unknown字段，检测□和?字符。
5.4 多个表格时取错了表
现象：文档里第一个表格是“课程信息”，第二个才是“成绩登记”，代码默认取了第一个，结果全是课程名。
原因：doc.tables[0]只取第一个表格，没有做表头判断。
解决：遍历所有表格，检查第一行是否包含“学号”“姓名”“成绩”等关键词：
def find_score_table(doc): """找到包含学号/姓名/成绩表头的表格""" keywords = {"学号", "姓名", "成绩"} for table in doc.tables: if not table.rows: continue header = [cell.text.strip() for cell in table.rows[0].cells] if keywords.issubset(set(header)): return table return None参数上，keywords可以根据实际表头调整，比如有些表用“分数”而不是“成绩”，加进去即可。
5.5 并发转换时 LibreOffice 卡死
现象：批量处理时，跑到第 10 个文件左右，LibreOffice 进程卡住不退出，后续文件全部超时。
原因：LibreOffice 的用户配置目录被多个进程同时占用，导致死锁。
解决：给每个转换任务指定独立的UserInstallation目录：
libreoffice --headless -env:UserInstallation=file:///tmp/lo_profile_$$ \ --convert-to docx --outdir ./converted "成绩登记表(2).doc"$$是当前进程 PID，保证每个任务用不同的配置目录。代价是每次转换会多花一点时间初始化配置，但稳定性大幅提升。如果文件量特别大，建议用队列串行处理，不要并发。
6. 进阶技巧：用表头映射和校验规则让管道自己发现异常
前面讲的都是“能跑通”的层面，但真实项目里，跑通只是第一步。成绩数据一旦错位，后续的绩点计算、排名、报表全是错的，而且很难查。我一般会在管道里加两层保险：表头映射和校验规则。
表头映射的思路是：不硬编码列索引，而是根据表头文字动态确定每列的含义。这样即使不同班级的表格列顺序不一样，也能正确解析。
HEADER_MAP = { "学号": "student_id", "姓名": "name", "成绩": "score", "分数": "score", "班级": "class_name", } def build_column_index(header_row): """根据表头文字建立列索引映射""" col_idx = {} for i, cell in enumerate(header_row): text = cell.text.strip() if text in HEADER_MAP: col_idx[HEADER_MAP[text]] = i return col_idx逻辑说明：HEADER_MAP把常见表头文字映射到统一字段名，build_column_index返回{"student_id": 0, "name": 1, "score": 2}这样的字典。后续取值用row[col_idx["student_id"]]，不再依赖固定列号。参数上，如果表头有“平时成绩”“期末成绩”这种细分，可以扩展HEADER_MAP，把不同列映射到不同字段。
校验规则层，我一般会加三条硬规则：学号在班级内唯一、成绩在 0 到 100 之间、姓名不为空。任何一条不满足，就把这行标记为suspect，输出到单独的文件里，不进入主数据。
def validate_rows(rows): """校验数据，返回 (valid, suspect)""" valid, suspect = [], [] seen_ids = set() for row in rows: errors = [] if row["student_id"] in seen_ids: errors.append("学号重复") if row["score"] is not None and not (0 <= row["score"] <= 100): errors.append("成绩越界") if not row["name"]: errors.append("姓名为空") if errors: row["errors"] = errors suspect.append(row) else: seen_ids.add(row["student_id"]) valid.append(row) return valid, suspect逻辑说明：seen_ids在循环中累积已出现的学号，重复的进入suspect。成绩越界和姓名为空同样标记。参数上，suspect文件建议保留原始行号和错误原因，方便人工核对。
这套管道跑下来，一个 50 文件的目录大概 3 到 5 分钟能处理完，其中大部分时间花在 LibreOffice 转换上。如果追求速度，可以把转换步骤换成 Windows 上的 COM 接口调用 Word，但那样就绑定了 Windows 环境，服务器上跑不了。我一般还是用 LibreOffice，稳字优先。
最后说个我自己的习惯：每次处理完一批成绩表，我都会把suspect文件打开看一眼，哪怕只有几行。因为成绩数据的错误往往不是技术问题，而是源文件本身就有问题——比如老师手动改过某个学生的分数但没保存对，或者复制粘贴时串了行。这些错误只有人眼能发现，管道只能帮你缩小范围。希望帮到你。
本文还有配套的精品资源，点击获取
