简介一份Scratch入门教程PDF面向零基础儿童与初次接触编程的青少年旨在通过积木式编程降低学习门槛帮助孩子从创作动画、游戏起步逐步建立计算思维与创造兴趣。资源共1个PDF文件约205KB内容以大量图解和实例操作为主不仅介绍Scratch界面、素材库及简单项目制作还循序讲解顺序、分支、循环等程序结构以及常量、变量、链表、消息、事件等基础概念适合家长和老师在家庭或课堂场景中陪孩子共同学习。目前已有798人学习下载。教程不仅讲解软件用法还穿插了儿童编程教育价值与应用前景帮助读者理解为何要引导孩子从“被动玩游戏”转向“主动编程序”并在创作过程中锻炼逻辑表达与解决问题能力。对于希望快速入门Scratch、开展少儿编程启蒙的读者来说这份精简PDF可作为第一份参考资料。1. 一份Scratch入门教程PDF凭什么让人看完就想动手很多人在网盘里下到一个叫“Scratch入门教程.pdf”的文件打开后却觉得和官方Wiki没什么区别全是角色、积木、舞台的截图从头翻到尾好像什么都讲了回到编辑器里还是不知道“克隆体”该放在哪个事件下面。这里有一个反直觉的结论Scratch这类块编程恰恰是文字描述效率最高的教学载体因为每个积木的形状、参数和嵌套关系都可以用精确的文本表达出来比如“把‘移动10步’放进‘重复执行10次’里”。一块积木住进另一块积木这种包含关系在PDF里比在视频里更容易反复对照。这里要处理的就是“Scratch入门教程.pdf”这个产出物不管你是想找一份能照着敲的教材还是要自己整理一份发给学生最终都要回答同一个问题——怎么把图形化编程的原子操作变成静态页面上可复现、可检索的教程。与其到处找PDF编辑器不如直接搭建一条“Markdown → PDF”的文档管线顺便把书签、中文避头尾和代码块高亮都调好。篇文章的结构也会按照“内容设计 → 工具链 → 排版 → 验证”的顺序展开。适合读这篇文章的人有两类一类是从没碰过Scratch但已经能写两行代码的程序员另一类是少儿编程机构的讲师想在每节课后生成统一格式的PDF讲义。下面的内容不依赖任何特定IDE所有命令都能在你的电脑上原样执行。2. 内容先行Scratch入门教程必须覆盖的五个模块2.1 从舞台区和角色区讲起PDF里怎么画界面任何一份入门教程PDF第一件要交代的不是“什么是编程”而是角色所处的坐标系。Scratch的舞台宽480、高360原点在中心x轴范围是-240到240y轴范围是-180到180。初学时很容易把原点当成左上角然后发现“移动到随机位置”总跑偏。所以在PDF里要先用一张简单的表格把这组数值固化下来而不只是贴截图因为截图上的坐标是动态的文字才是恒定的。区域用途教程里需要写明的数值舞台区角色可见层480×360坐标原点在中心角色区当前角色列表角色名、x/y坐标、方向、大小积木区按颜色分类的积木9大类积木的颜色和用途为了不依赖截图可以用代码块画一个角色坐标示意图直接放进Markdown源文件。这样后续无论排版怎么变图纸都不会模糊y180 ------ | | | (0,0)| | | ------ y-180 x-240 x240这段文本的作用是让读者建立一个“中心原点”的直觉。旁边的正文里要补一句关键解释Scratch里的坐标不是像素坐标而是舞台的逻辑坐标1个单位约等于1像素当角色x坐标大于240或小于-240时部分身体会跑到舞台外面但不会报错。这个说明能帮你少回答几十次“为什么角色不见了”。2.2 积木块分类用颜色表帮助读者建立映射Scratch积木分成运动、外观、声音、事件、控制、侦测、运算、变量、自制积木九大类。在PDF的灰度印刷环境下颜色区分度会很差所以教程里不能只写“把蓝色积木拖出来”而要把每一类的名称和典型积木列清楚分类典型积木需要说明的参数运动移动10步、右转15度步数、角度外观说…、将亮度特效设为…文本内容、特效值声音播放声音…声音名称事件当绿旗被点击、当按下空格键触发器按键名控制重复执行、如果…那么…否则…循环次数、条件侦测碰到鼠标指针、询问…并等待对象、问题文本运算相加、随机数…数值表达式变量将变量设为…变量名、新值以“将亮度特效设为50”为例这个积木属于外观类参数范围是-100到100亮度调到100时角色会变成全白调到-100时接近全黑。很多初学者会把它和“将颜色特效设为”搞混教程里必须用一句话点破颜色特效改变的是色相亮度不改变色调。这张表之后还要配一个练习让学生用“在0到100之间取随机值”设置亮度观察角色闪烁。2.3 用“小鱼游泳”把顺序、循环、条件一次性讲透顺序结构的教学不建议一上来就讲事件驱动因为事件往往是隐式的。我一般用“小鱼从屏幕右边游回来”这个例子把顺序、循环和条件放在同一个场景里。第一版代码只有三组积木当绿旗被点击 将x坐标设为 200 将y坐标设为 0 重复执行 将x坐标增加 -2 如果 x坐标 -240那么 将x坐标设为 200这段积木序列用缩进表示嵌套重复执行里包含两个动作如果在循环体内。读者需要理解的关键参数是-2它表示每次循环向左移动2个单位如果 x坐标 -240是回头条件。这里不要只说“移到左边就重置”要解释为什么是-240而不是-260角色中心点到达舞台左边缘时x坐标正好是-240继续减会让角色完全跑出视野重置成200能保证从右侧重新进场。这个例子同时折射出一个常见误区Scratch的“碰到边缘就反弹”积木只改变方向不负责把角色拉回舞台内。所以让角色来回游时更好的做法是用条件判断配合坐标归零。把这一点写进教程PDF可以避免学生在做贪吃蛇时撞墙后角色卡死。当这个例子跑通后再让学生用同样的循环加条件结构写九九乘法表顺便理解变量自增。2.4 教程里必须含的“错误对照表”初学者的挫败感通常不来自难懂的概念而是来自“照做了却不动”。因此教程PDF里需要一张“你以为 vs 实际”对照表直接放在每节课的最后情形你以为的原因实际原因修正方法点绿旗没反应绿旗没放上去事件类没有“当绿旗被点击”从事件类拖出该积木角色一闪而过电脑卡了循环体没有等待在循环末尾加“等待0.01秒”x坐标越来越小到几千角色出界了没有仿真边界条件加坐标判断或“碰到边缘就反弹”这张表每一条都应该配一个排错步骤不能光给结论。比如第一条的步骤是1) 检查脚本区顶部有没有黄色的事件积木2) 点击绿旗时看脚本区是否出现黄色高亮3) 如果高亮了但角色不动去角色区确认当前选中的角色和脚本是不是同一个。把排错习惯写进PDF比单独讲语法更能在入门阶段减少挫败感。3. 把Markdown变成PDF三种可靠管线与参数调整3.1 Pandoc XeLaTeX处理中文最稳的组合教程正文建议先用Markdown写好再用Pandoc转换PDF。不是说Word不行而是Markdown文件可以用Git管理版本讲师每次修改后只需一条命令就能重新编译。转换中文时我最常用的是Pandoc加XeLaTeX引擎pandoc scratch_tutorial.md -o scratch_tutorial.pdf --pdf-enginexelatex -V mainfontNoto Sans CJK SC -V monofontNoto Sans Mono CJK SC -V geometry:margin2.5cm -V colorlinkstrue逻辑说明--pdf-enginexelatex把默认的pdfLaTeX换成XeLaTeX因为后者能直接调用系统字体中文不再需要繁琐的CJK宏包配置mainfont设置正文中文字体Noto Sans CJK SC是开源字体在Windows、Linux、macOS上都有对应版本monofont设置代码块里的等宽字体让积木文本天然对齐geometry:margin2.5cm控制页边距为上下左右2.5厘米colorlinkstrue会把PDF内部的交叉引用超链接从红框改为彩色文字更适合在屏幕上阅读。提示如果你的系统没有Noto Sans CJK SC编译时会报“Cannot find font”。安装字体后记得刷新字体缓存Linux执行fc-cache -fPandoc才能找到它。如果你的读者里有大量移动端用户2.5cm边距会让正文每行约15个汉字在手机上横屏阅读也舒服。这个参数不是越小越好1.5cm边距看起来很紧凑但中文长段落会显得拥挤不利于做笔记。XeLaTeX和WeasyPrint的适用场景不同可以在教程项目的README里用表格说明管线优点适合场景Pandoc XeLaTeX自动目录书签、中文排版成熟纯文本教程、长文档WeasyPrint HTML精确控制积木颜色样式需要大量彩色积木块的教程浏览器打印零配置但样式不可控临时草稿、截图拼接3.2 WeasyPrint HTML给积木块着色更容易当教程需要大量展示积木块时Pandoc自带的代码高亮并不能区分“运动积木”和“控制积木”。这时可以用WeasyPrint它接受HTML和CSS渲染出来的PDF对颜色和圆角的控制与浏览器完全一致。你需要先把Markdown转成HTML再调用WeasyPrintfrom weasyprint import HTML HTML(scratch_tutorial.html).write_pdf(scratch_tutorial.pdf, stylesheets[style.css])这段代码只有两行但背后有一个重要参数stylesheets指定CSS文件列表多个样式表会按顺序合并后面的优先级更高。CSS里可以给不同积木类定义不同的背景色.block-motion { background-color: #4C97FF; color: white; padding: 4px 8px; border-radius: 6px; font-family: Noto Sans Mono CJK SC, monospace; } .block-control { background-color: #FFAB19; color: white; padding: 4px 8px; border-radius: 6px; font-family: Noto Sans Mono CJK SC, monospace; }参数说明background-color使用Scratch官方颜色运动类#4C97FF控制类#FFAB19外观类#9966FF变量类#FF8C1A。border-radius: 6px是积木圆角这个值和Scratch编辑器的显示效果基本一致。这样生成的PDF里读者不用反查颜色表光凭色块就能判断积木类别。WeasyPrint的一个坑是它对某些CSS3属性支持不全比如grid布局不支持但教程排版一般用不到。排版时建议用float或table兼容性更好。另外WeasyPrint默认不会把HTML标题自动映射成PDF书签需要额外编写JavaScript或使用其Python API设置文档大纲这一点在下文4.3会有验证方法。3.3 Microsoft Print to PDF 与浏览器打印的适用边界Windows自带的“Microsoft Print to PDF”虚拟打印机几乎人人都有很多讲师为了省事直接把Scratch官网项目页面打印成PDF。这样得到的文件有几个问题页面背景被吃掉、代码区跨页裁切、中文可能变成细体。它适合打印截图和临时草稿不适合作为正式教程。如果你仍然需要走浏览器打印可以在HTML里加入下面的CSS把代码块改成可换行的样式pre { white-space: pre-wrap; word-break: break-all; background-color: #F6F8FA; padding: 12px; border-radius: 8px; }white-space: pre-wrap保留文本里的空格和换行同时允许遇到边界时软换行word-break: break-all强制长行在任意字符间断行防止积木文本超出页面宽度。两个属性缺一不可只有pre-wrap英文长单词“RepeatForever”会被整体搬到下一行留出大片空白只有word-break空格会被折叠。配合padding: 12px打印出来的代码块有呼吸感适合手写笔记。Microsoft Print to PDF还有一个特征是它会以打印机默认分辨率输出如果你在打印设置里选择“草稿质量”PDF里的中文字体边缘会变虚。正式发布请打开“高质量打印”选项。相比Pandoc的命令行管线浏览器打印无法自动生成目录和书签所以它只能作为临时备用方案。3.4 用Python批量生成每章PDF当教程分成十几个章节时一条条运行Pandoc命令效率太低。我一般用下面这个Python脚本按文件名顺序批量生成from pathlib import Path import subprocess md_dir Path(md) out_dir Path(out) out_dir.mkdir(exist_okTrue) for md_file in sorted(md_dir.glob(*.md)): out_pdf out_dir / (md_file.stem .pdf) cmd [ pandoc, str(md_file), -o, str(out_pdf), --pdf-enginexelatex, -V, mainfontNoto Sans CJK SC, -V, monofontNoto Sans Mono CJK SC, -V, geometry:margin2cm, ] subprocess.run(cmd, checkTrue) print(f已生成 {out_pdf})逻辑说明sorted(md_dir.glob(*.md))按文件名排序所以章节文件建议命名为01_xxx.md、02_xxx.md这样第10章10_xxx.md会排在02之后而不是09和01之间。checkTrue的作用是当Pandoc返回非零退出码时立即抛出异常避免某个章节编译失败后你还继续生成后面的文件最后缺内容却不知道。用subprocess.run而不是os.system是因为列表传参不会受空格和特殊字符影响中文文件名也能安全处理。如果你需要把多个章节合并成一个PDF可以先把它们拼接成一个大Markdown再转换而不是直接合并PDF否则目录页码会乱。拼接时注意在章节之间插入\newpage保证每个大章节从奇数页开始。4. 排版细节让PDF教程在阅读器里真正“好用”4.1 代码块高亮与积木序列的视觉区分写教程时常见做法是正文段落和积木序列用同一种代码块但读者很难一眼看出“哪段是要操作的”。我们可以通过给代码块设置语言标识来更换高亮。Pandoc中代码块第一行支持语言标签例如scratch 当绿旗被点击 重复执行 移动10步但Pandoc并没有内置scratch语言高亮引擎会把它当普通文本处理。这时候可以借用text语言再配一个自定义高亮样式。Pandoc的--highlight-style参数支持tango、espresso、zenburn等内置主题。对Scratch教程来说tango的默认色系对积木文本最友好因为它不会把等宽字体改成花体而是保留清晰的前景色。 bash pandoc md/tutorial.md -o tutorial.pdf --pdf-enginexelatex --highlight-styletango -V mainfontNoto Sans CJK SC参数说明--highlight-style只影响带语言标识的代码块。如果你的积木块没有标注语言这段代码不会生效。所以建议所有积木块统一用text标注这样至少能得到一个一致的前景和背景色。更好的做法是在用WeasyPrint时给不同文本行添加CSS类但那样需要中间加工Pandoc不方便实现具体可以看上一章3.2的CSS方案。高亮主题背景色适合Scratch积木文本吗tango浅灰适合绿色和蓝色区分度较高espresso深褐对比强但打印耗墨zenburn暗绿灰适合夜间阅读不适合纸面打印monochrome白无颜色适合纯文字教程4.2 分页控制避免一个积木块被拆到两页PDF教程的阅读体验画面断裂影响最大。一个只有六行的积木块跨页后读者必须来回滚动才能看懂嵌套关系。在LaTeX引擎下可以使用两个底层参数\widowpenalties 1 10000 \clubpenalties 1 10000\widowpenalties控制页尾出现孤行的惩罚值\clubpenalties控制页首出现孤行。默认值在150左右但把惩罚值提高到10000后渲染器会优先把整段移出页边而不是截成两段。这两个参数不是Pandoc的内置变量需要写一个header.tex文件然后用Pandoc的--include-in-header参数引入pandoc md/tutorial.md -o tutorial.pdf --pdf-enginexelatex --include-in-headerheader.texheader.tex内容就是上面的两行。这个方法对中文段落效果也很明显能避免标题前一行落在页面底部出现“孤行标题”的情况。如果用WeasyPrint对应方案是给pre加break-inside: avoid;pre { break-inside: avoid; }该属性允许渲染器不拆分元素。需要注意这个属性只适用于块级元素如果积木块使用span包着就不会生效。所以我通常会把每个积木序列包成div classscratch-block再设置样式。分页控制是PDF排版里最容易被忽视的参数但它直接决定了读者愿不愿意在手机屏幕上逐页读下去。4.3 PDF书签和目录使用--toc与PDF元数据一本入门教程如果没有书签移动端屏幕上翻页会很痛苦。Pandoc生成带书签的PDF很简单pandoc md/tutorial.md -o tutorial.pdf --pdf-enginexelatex --toc --toc-depth3 -V linkcolorblue--toc会生成目录页--toc-depth3表示目录中包含到三级标题。这里的“三级”对应Markdown里的###。linkcolorblue把目录和交叉引用中的链接文字设为蓝色方便读者在屏幕上用鼠标点击跳转。生成的PDF在阅读器左侧会显示可展开的书签原因是LaTeX的hyperref宏包会自动把目录项映射成PDF书签。但中文书签有个常见坑如果主字体没有配置好LaTeX生成的书签会出现乱码或丢失。解决方案是在YAML元数据中声明CJK主字体--- CJKmainfont: Noto Sans CJK SC ---这样书签和PDF正文使用同一套字体。如果仍然出现乱码可以把Markdown文件本身转成UTF-8无BOM格式。WeasyPrint生成PDF时不会自动生成书签你需要在HTML中设置h1到h3的标题层级然后在Python代码中调用document.add_outline()from weasyprint import HTML doc HTML(scratch_tutorial.html).render() doc.add_outline() doc.write_pdf(scratch_tutorial.pdf)add_outline()会扫描文档里的标题标签生成PDF书签。前提是标题标签不能跨章节嵌套跳级比如h1下面直接跟h3会导致大纲结构错乱。这一参数对移动端阅读器尤其重要没有书签的PDF在一个章节有30页时几乎无法导航。5. 进阶让PDF里的Scratch项目可点击、可验证5.1 嵌入可点击的项目链接在Scratch官网上每个项目都有一个唯一的ID。把链接作为超链接放进PDF比贴一张项目截图有用得多。Markdown写法[跳到“小鱼游泳”项目](https://scratch.mit.edu/projects/126644823)转换时加上-V colorlinkstrue参数链接文字显示为蓝色且可点击。如果没有这个参数链接会出现红色边框打印出来很难看。链接文字不要用“请点击这里”直接写项目名这样纸质版打印出来也有意义。5.2 用Python验证PDF中的外链和书签生成后可以用PyMuPDF快速检查链接有没有被写入import fitz doc fitz.open(scratch_tutorial.pdf) count 0 for page in doc: for link in page.get_links(): if link[kind] fitz.LINK_URI: count 1 print(f页码 {page.number 1}: {link[uri]}) print(f外链总数: {count})fitz.LINK_URI是PyMuPDF对普通URL链接的标记get_links()返回所有链接对象。如果输出为空往往不是因为Pandoc没生成而是Markdown里链接语法写错了比如括号用了中文。这个脚本应该作为发布前的固定检查把它挂在教程项目的scripts/目录下每次编译PDF后自动跑一遍。5.3 最后的检视中文标点与空白页最后一个常用技巧是检查中文标点是否出现在行首。中文排版不允许逗号、句号排在一行行首LaTeX配合xeCJK会自动处理但WeasyPrint需要额外设置。发布前用pdftotext导出行首标点pdftotext -layout scratch_tutorial.pdf - | grep ^[。]没有输出就说明行首干净。如果出现回到CSS增加text-justify: inter-ideograph或者换用XeLaTeX管线。这一验证无法被完全自动化替代但却是PDF专业感的关键。检查完标点后还要把PDF翻到目录页确认每个章节标题和右侧页码没有错位特别是当Markdown里含有中英文混排标题时页码对齐容易因为字体宽度差异产生偏移。如果你要把这个流程自动化可以在GitHub Actions里添加定时构建任务每次main分支更新时运行Pandoc命令输出文件名用日期标记为scratch-tutorial-20250106.pdf。这样每节课后学生拿到的都是带日期版本号的同一份教程不会出现“到底改没改”的混乱。本文还有配套的精品资源点击获取