tchMaterial-parser 完整教程：把智慧教育平台的电子课本 PDF 存到本地-育师

tchMaterial-parser 完整教程：把智慧教育平台的电子课本 PDF 存到本地

【免费下载链接】tchMaterial-parser国家中小学智慧教育平台电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。项目地址: https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser

给娃查课本、备课找教材，登录国家中小学智慧教育平台后你会发现：课本只能在线翻，页面上找不到任何保存按钮。tchMaterial-parser 就是解决这件事的——它能把课本预览页背后的 PDF 直链解析出来，让你把课本完整下载到本地，离线随时打开。全程只需粘贴一个页面地址。

🧭 先看它能干什么：几个实用功能

整套教材一次下完：输入框里可以贴多个预览地址，每行一个，点一次"下载"就并行解析并拉取全部课本，不用一本一本点。
级联菜单挑课本：懒得在浏览器里翻地址，就用界面上的下拉菜单按学段、学科、年级、版本逐级选，选到最末级时，预览地址会自动填进输入框。
只拷直链不下载：不想让程序参与传输？点"解析并复制"，PDF 直链直接进剪贴板，交给 IDM 或浏览器自己存。
配套音频顺手拿：教材如果关联了音频素材，mp3 会跟着 PDF 一起被拉下来，存进以教材名命名的"音频"文件夹，一次操作两样到手。
进度和日志看得清：进度条实时显示已下载大小和剩余文件数；底部日志会逐条列出解析或下载失败的链接，方便你只重试失败的那几条。

📥 上手流程：从克隆到第一份本地 PDF

1. 安装

git clone https://gitcode.com/GitHub_Trending/tc/tchMaterial-parser cd tchMaterial-parser pip install requests pyperclip psutil

第三方依赖就这三个库，这条 pip 命令一次装齐。

2. 启动

Windows 下直接双击src/tchMaterial-parser.pyw；其他系统用python src/tchMaterial-parser.pyw启动。有个细节要提前说：首次启动时程序会在后台拉取平台的全量课本目录来填充下拉菜单，所以窗口可能要等多几秒钟。别以为卡死了，这不是故障。

3. 输入并解析

在平台上打开目标课本的预览页，把浏览器地址栏里的完整网址复制出来，粘进程序的输入框。

4. 下载保存

点"下载"，选一个保存文件夹。程序会解析出页面背后的 PDF 地址并开始下载，文件名直接取教材标题，比如"小学数学_三年级_上册_人教版.pdf"，不用你手动改名。到这一步，你手里就有第一本能离线打开的电子课本了。

🧰 环境准备与避坑：开跑前自查清单

Python 3.x，外加一个带图形界面的系统。tkinter 是 Python 自带的，一般不用额外装。
运行直接报导入错误、且你在 Linux 上：发行版通常不打包 tkinter，装一下sudo apt install python3-tk就通了。
下拉菜单是空的：启动时拉课本目录要连外网，公司内网这类受限网络下会拉不到，不影响你手动粘贴网址使用。
高分屏界面发虚：Windows 下程序会读取系统缩放自动做高 DPI 适配，正常直接可用；仍显示不对的话，先去系统显示设置里调一下缩放比例再打开程序。

🔍 故障排查：现象 → 原因 → 处理办法

现象：网速没问题，但你希望用 IDM 这类工具接管下载。原因：程序"下载"按钮默认自己解析加传输。处理：改用"解析并复制"，程序只负责把预览地址翻成直链并放进剪贴板，不参与传输，后面怎么存由你决定。
现象：课本下好了，配套的音频素材还想要。原因：平台上音频没有单独的下载入口，容易让人以为要另找途径。处理：不用另找。程序解析教材时会顺带拉取关联音频，下载 PDF 的同时 mp3 会自动存进以教材名命名的"音频"文件夹。
现象：高分屏上界面发虚、按钮错位。原因：显示缩放没有正确适配。处理：Windows 下程序已自动适配系统缩放，若仍不正常，先调系统缩放比例再打开程序。
现象：某条链接提示解析失败。原因：多半是网址本身不完整，或者页面已下线。处理：回平台重新打开那本课本的预览页，复制新地址再试。日志只列出失败的那几条，成功的不用重下。