## 1. 五宫格数独：为什么它更适合教学？ 如果你是一位老师，或者家里有正在上幼儿园或小学低年级的孩子，你一定对“数独”这个游戏不陌生。传统的九宫格数独虽然经典，但对于年龄较小的孩子来说，81个格子、复杂的行列宫规则，往往让他们望而却步，还没体验到逻辑推理的乐趣，就先被挫败感打败了。我自己在给孩子做思维训练时，就深有体会。后来，我把目光投向了**五宫格数独**。 五宫格数独，顾名思义，就是在一个5x5的盘面上进行游戏。它比九宫格小得多，规则却一脉相承：每一行、每一列以及用粗线划分出的五个“宫”（通常是2x3或3x2的不规则形状，但更简单的版本是5x5的盘面直接划分为5个1x5的“行宫”或“列宫”，我们这里讨论的是更常见的、规则简化的5x5宫格，即每行、每列、每个粗线宫（5格）内数字1-5不重复）。盘面小，题目生成快，孩子一眼就能看完，更容易建立信心。我试过在课堂上用，孩子们从完全不懂到能独立完成第一个题目，最快只用了不到10分钟。 但问题来了，去哪里找那么多合适的五宫格题目呢？网上的资源要么难度固定，要么格式乱七八糟，打印出来不美观，更别说想根据孩子的学习进度，灵活调整题目的难度了。手动出题？那更是耗时耗力，出几道题一晚上就过去了。所以，我决定自己动手，用Python写一个自动化生成工具。这不仅仅是“偷懒”，更是为了让教学材料能真正“个性化”，贴合每个孩子或每个班级的实际水平。今天要分享的，就是这个经历了多次迭代，最终打磨出来的“五宫格数独9.0”生成器。它不仅能批量生成，最关键的是，你可以像调节音量一样，轻松控制题目的**难度**和**填空比例**，想要简单点还是烧脑点，完全由你说了算。 ## 2. 核心思路：如何让Python“学会”出数独题？ 要让电脑自动出题，我们得先把它变成一个电脑能理解的流程。整个过程可以拆解成两个核心步骤：**第一步，生成一个完整的、符合数独规则的终盘（也就是答案盘）；第二步，从这个终盘上，按我们想要的难度挖掉一些数字，形成题目**。 听起来简单，但里面有不少门道。首先生成终盘，对于五宫格来说，比九宫格简单不少。九宫格常用的回溯算法（一种试探性的搜索算法，走不通就回退）当然可以用，但杀鸡焉用牛刀？五宫格总共才25个格子，我们甚至可以玩点“花样”。我最初参考了一些九宫格的生成代码，发现直接套用过来，虽然能跑，但生成速度不是最优的，而且代码对于教学者来说有点难以理解。所以，我做了大量简化。 **一个更“教学友好”的生成思路是这样的**：我们可以先确定第一行是数字1-5的一个随机排列。然后，根据数独的规则去推导或填充剩下的行。对于5x5且宫规则为行/列约束的简化版本，这甚至可以通过矩阵变换快速完成。但在我们当前这个追求通用性和可调难度的9.0版本中，我依然选择了**递归回溯算法**作为核心。为什么？因为它足够经典、健壮，并且稍加修改就能适应未来可能变化的规则（比如变成六宫格）。理解了这个算法，你就能触类旁通。 简单解释一下这个算法：程序从盘面的第一个格子（左上角）开始，尝试填入一个随机数字（1-5），然后检查这个数字是否违反了当前行、当前列以及所在宫的规则。如果没问题，它就跳到下一个格子继续尝试。如果某个格子试遍了1-5所有数字都冲突，那就说明前面某步走错了，于是它“回溯”到上一个格子，换一个数字再试。这个过程就像走迷宫，碰壁了就退回上一个岔路口换条路，直到最终走通，生成一个完美的终盘。 有了终盘，下一步就是“挖空”来制造题目。这里就是控制难度的关键了！你不能随机乱挖，否则可能挖出多个答案的“无效题目”。我们的策略是：**先生成终盘，然后随机选择一定数量的格子，将其数字隐藏（变成空格）**。而“挖多少”，就直接由你控制的**填空比例**参数决定。比如，你设置填空比例为50%，那么25个格子里，大约就会挖空12-13个。比例越高，题目越难。我实测下来，对于初学者，20%-30%的填空比例（即保留15-20个已知数）非常合适，既能引导思考，又不会太难。而对于想要挑战的孩子，完全可以把比例调到60%甚至70%。 ## 3. 代码实战：一步步拆解生成器 光讲原理不够过瘾，我们直接上代码，我把关键部分拆开，用“人话”讲给你听。你不需要是编程高手，跟着我的注释，一定能看懂。 首先，我们需要准备一个Python环境，安装几个必要的库。打开你的命令行（Windows叫CMD或PowerShell，Mac叫终端），输入以下命令： ```bash pip install python-docx PyPDF2 ``` 这里，`python-docx`用来操作Word文档，生成我们最终排好版的数独题纸；`PyPDF2`则是为了把生成的多份Word题单合并成一个PDF文件，方便打印。这些都是非常常用的库，安装很简单。 接下来，是代码的骨架。我会把完整代码放在最后，这里我们先看最核心的生成部分。 ### 3.1 生成终盘：递归回溯算法的实现 这是整个程序的大脑。我写了一个叫 `generate_sudoku_board` 的函数。 ```python import random import copy hs = 5 # 宫格尺寸，5就是五宫格 def generate_sudoku_board(): # 初始化一个5x5，全是0的二维列表 board = [[0] * hs for _ in range(hs)] def filling_board(row, col): # 如果已经填完了最后一行（row == 5），说明成功了，返回True if row == hs: return True # 计算下一个格子的位置：先从左到右，到底了就换行 next_row = row if col < hs-1 else row + 1 next_col = (col + 1) % hs # 随机生成1-5的数字序列，这样每次生成的终盘都不同 numbers = random.sample(range(1, hs+1), hs) for num in numbers: # 检查规则：当前行、当前列是否已经存在这个数字？ # 对于五宫格，我们这里简化了“宫”的检查，假设宫就是行/列约束。 # 更严格的检查可以加上，但为了清晰，我们先这样写。 if num not in board[row] and all(board[i][col] != num for i in range(hs)): board[row][col] = num # 可以填，就放进去 # 递归地去填下一个格子 if filling_board(next_row, next_col): return True # 如果递归回来发现失败了，说明这个num不行，回溯，清空这个格子 board[row][col] = 0 # 所有数字都试过了都不行，返回False，让上一层回溯 return False # 从(0,0)位置开始填充 filling_board(0, 0) return board ``` 你可以把这段代码复制到一个Python文件里，然后调用 `print(generate_sudoku_board())`，看看它是不是每次都能生成一个全新的、正确的五宫格终盘。我测试过上百次，非常稳定。 ### 3.2 挖空制造题目：难度控制的核心 生成了完美的终盘（我们叫它 `answer_board`），接下来就要制造题目了。我写了另一个函数 `create_puzzle`。 ```python def create_puzzle(difficulty_ratio): """ difficulty_ratio: 难度比例，比如0.5表示挖空50%的格子 """ answer = generate_sudoku_board() # 拿到一个终盘 puzzle = copy.deepcopy(answer) # 深拷贝一份，用来挖空 total_cells = hs * hs # 总格子数，5*5=25 # 计算要挖空的数量，比如0.5*25=12.5，取整后是12或13个空 blanks_count = int(total_cells * difficulty_ratio) # 随机选择要挖空的位置。random.sample确保不重复选择。 positions = random.sample(range(total_cells), blanks_count) for pos in positions: row = pos // hs # 整除得到行号，比如 pos=13, 13//5=2 col = pos % hs # 取余得到列号，比如 pos=13, 13%5=3 puzzle[row][col] = 0 # 挖空，用0表示 return puzzle, answer # 返回题目和答案，方便后续核对 ``` 看，控制难度就是这么简单！你只需要改变 `difficulty_ratio` 这个参数。比如： - `create_puzzle(0.3)` 生成一个填空30%（大约留17个提示数）的简单题。 - `create_puzzle(0.6)` 生成一个填空60%（大约只有10个提示数）的困难题。 我建议你从0.4开始尝试，看看生成的题目感觉如何。这个参数给了你无穷的灵活性，你可以为班里不同水平的孩子准备不同难度的练习纸，真正做到因材施教。 ### 3.3 批量生成与排版：输出到Word和PDF 单个题目生成好了，但我们教学往往需要批量打印。这部分代码负责把题目漂亮地排列到A4纸上，并保存为PDF。我设计的是**一张15cm x 15cm的手工纸上，排列4个独立的五宫格题目**，这样裁剪方便，也节约纸张。 这里用到了 `python-docx` 库来操作一个预先设计好的Word模板。模板里有一个5x5的表格，对应一个五宫格。我们需要做的是： 1. 循环生成指定份数（比如20份）的题目。 2. 每份题目有4道题（对应一页纸）。 3. 把每道题的25个数字（或空格）填到Word模板对应的25个单元格里。 4. 将每一页Word转换为PDF，最后合并成一个大的PDF文件。 关键的填充代码如下（已简化，聚焦逻辑）： ```python from docx import Document from docx.shared import Pt, RGBColor from docx.enum.text import WD_PARAGRAPH_ALIGNMENT # 假设我们有一个包含所有题目数字的列表 all_puzzles_numbers # 以及一个Word模板，模板里第一个表格就是我们要填的宫格 doc = Document('五宫格数独模板.docx') table = doc.tables[0] # 获取第一个表格 # bg 是一个列表，定义了模板中25个单元格的位置坐标，例如['0000', '0001', ...] # Q 是当前这道题的25个数字（0代表空）的列表 for i in range(len(bg)): pos = bg[i] row_idx = int(pos[0:2]) # 解析出行坐标 col_idx = int(pos[2:4]) # 解析出列坐标 cell_value = str(Q[i]) if Q[i] != 0 else '' # 如果是0，就填空字符串 # 获取表格中对应的单元格，并写入值 cell = table.cell(row_idx, col_idx) paragraph = cell.paragraphs[0] run = paragraph.add_run(cell_value) run.font.name = '黑体' # 设置字体 run.font.size = Pt(22) # 设置字号 run.bold = True # 加粗 paragraph.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER # 居中 # 保存这一份题目 doc.save(f'临时题目_{page_num}.docx') ``` 排版和样式调整是让成品看起来专业的关键。我选择了**黑体加粗**，字号22磅，颜色深灰色（RGB(50,50,50)），并且居中对齐。这样打印出来非常清晰，孩子看起来不费眼。你可以根据自己的喜好，在代码里调整这些字体、颜色参数。 ## 4. 如何使用：从运行到打印的完整指南 好了，最复杂的部分我们已经搞定了。现在，我来手把手教你如何运行这个脚本，生成属于你自己的定制数独题册。 **第一步：准备文件。** 1. 将前面讲解的所有代码片段整合到一个 `.py` 文件中，比如命名为 `sudoku5x5_generator.py`。 2. 准备一个Word模板文件，命名为 `数独正方形五宫格.docx`。这个模板里需要有一个5行5列的表格，表格边框设置好，大小调整到适合一个宫格。你可以先手动创建一个，调整到你满意的样式。**注意**：代码中会读取这个模板，并根据 `bg` 列表的坐标往表格里填数字。`bg` 列表定义了数字填充的路径，你需要根据自己模板的表格结构来调整它。在原始代码中，`bg` 是通过循环生成的一系列坐标字符串，对应表格的特定单元格。如果你完全使用我提供的逻辑，那么模板中表格的左上角单元格坐标就是(0,0)。最稳妥的方法是，先运行一次代码，生成一个测试文件，看看数字填在了哪里，然后反过来调整你的Word模板表格，或者微调 `bg` 列表的生成逻辑。 **第二步：运行脚本。** 双击运行你的 `.py` 文件，或者在你的IDE里运行。脚本会依次问你几个问题，就像在和你对话一样： ``` 生成几份？ > 10 请输入5 > 5 空格比例，输入5，就是50%，就是空一半） > 4 ``` - **“生成几份？”**：这里输入的是你想要多少 **“页”**。一页纸上有4道题。输入10，就会生成10页纸，共40道不同的题目。 - **“请输入5”**：这是确认宫格大小，固定输入5即可（代表五宫格）。这个参数为未来扩展留了空间，比如你想做六宫格，这里就输入6，并相应调整模板。 - **“空格比例，输入5，就是50%”**：这是**最关键的难度控制**！输入范围是0-9。输入5，代表挖空50%（即难度比例0.5）。输入3，就是挖空30%（简单）。输入7，就是挖空70%（极难）。我一般用4或5，适合大部分孩子。 **第三步：获取结果。** 程序运行结束后，它会在你的桌面上（根据代码里的路径）生成一个PDF文件，名字类似 `（打印合集）05正方形数独五宫格9.0 5乘5（10人40份）.pdf`。这个文件包含了所有生成好的、排版整齐的数独题目，直接拿去打印就行。程序很贴心，它还会自动清理生成过程中产生的临时Word文件。 **几个你可能遇到的“坑”和解决办法：** 1. **报错“No module named ‘win32com’ 或 ‘docx’”：** 这说明库没安装全。请确保在命令行里执行了 `pip install python-docx PyPDF2 pypiwin32`。在Windows上操作Word通常还需要 `pypiwin32` 或 `pywin32`。 2. **生成的Word文件数字位置不对：** 这几乎肯定是你的Word模板表格结构，与代码中 `bg` 列表预设的坐标不匹配。解决方法是：先让代码生成一份题目，打开那个Word文件，看数字都跑到哪里去了。然后根据实际情况，修改代码中生成 `bg1`, `bg2`, `bg3`, `bg4` 那几个循环里的行列号。这部分有点繁琐，但一旦调通，以后就一劳永逸了。你可以把它理解为给打印机“校准”的过程。 3. **想调整题目在纸上的布局：** 比如想一页放2个题或者6个题。这需要修改两处：一是Word模板，设计新的表格布局；二是代码中组合 `bg` 列表的部分，让填充坐标对应到新模板的多个表格位置。这属于进阶玩法，等你熟悉了基本流程后，可以尝试挑战。 ## 5. 不止于五宫格：扩展思路与教学应用 这个“五宫格数独9.0”生成器，它的价值远不止是生成一些练习题。它背后是一套可复用的自动化教学材料生产流程。理解了这套逻辑，你可以举一反三，创造出更多有用的工具。 **首先，难度分级可以更精细。** 我们现在只通过控制空白格子的比例来调节难度，这其实是一种“量化难度”。更专业的数独难度还和空格的位置分布有关。比如，挖空的格子如果都挤在一起，可能反而比分散开更容易推理。你可以尝试修改 `create_puzzle` 函数中的 `random.sample` 部分，加入一些规则来控制挖空位置的“聚类程度”，或者优先挖掉某些关键位置的数字，来制造不同的难度曲线。 **其次，轻松扩展到其他宫格。** 这是这个程序最强大的地方。你想做**四宫格**给更小的孩子玩吗？只需要把代码开头的 `hs = 5` 改成 `hs = 4`，然后准备一个4x4的Word模板，并调整 `bg` 坐标列表的生成逻辑（因为格子总数变了）。同理，**六宫格**、**九宫格**都可以如法炮制。算法是通用的，你只需要改变尺寸参数和模板。我后来就用同样的框架，做了一个给高年级学生的九宫格生成器，只是回溯算法因为搜索空间变大，生成速度慢了一些，但对于出题来说完全够用。 **在教学中的应用场景非常广泛：** - **课堂练习：** 每天课前5分钟，快速生成一份难度适中的题目，作为思维热身。 - **分层作业：** 根据学生的能力，生成填空比例分别为40%、50%、60%的三套题目，让每个孩子都能“跳一跳，够得着”。 - **亲子活动：** 生成一套答案，把题目和答案分开打印。家长和孩子可以一起玩，或者比赛谁解得快。 - **竞赛材料：** 如果需要组织班级数独小竞赛，用这个工具可以快速生成大量不重复的、难度一致的题目，保证公平性。 我自己从1.0版本写到9.0版本，最大的感触就是，技术真的能让教育者的工作更高效、更精准。以前出题是体力活，现在变成了有创造性的设计工作——我只需要思考“我的学生今天需要什么样的挑战”，然后把参数告诉程序，一分钟内，一份量身定制的练习就诞生了。这节省下来的时间，我可以更多地用来观察学生的解题过程，给予个性化的指导。 最后，我想说，这个代码可能不是最优、最优雅的，但它足够实用，并且每一行都有明确的意图。我建议你在使用过程中，不要怕去修改它。比如，你觉得数字字体不好看，就去改 `run.font.name`；你觉得想增加一个“打印答案页”的功能，就在生成题目的同时把答案也输出到另一个表格里。编程工具的生命力，就在于它能被不断改造，以适应你真实的教学需求。希望这个“五宫格数独9.0”能成为你教学工具箱里一件趁手的利器，也希望你能从中感受到用技术赋能教育的乐趣。