简介：Moodle使用说明是一份面向教师与在线课程建设者的平台实操文档，重点解决课程资源创建、教学活动组织与平台功能上手等问题。压缩包内含1个doc文件，约9.02MB，以图文步骤和操作示例串联各功能模块，便于按章节查阅与课堂实践。内容围绕资源添加与呈现展开，涵盖文本页、编写网页、链接文件或站点、插入标签等资源类型，并延伸至程序教学与测验、BBS与投票、Wiki等教学活动，目录层次清晰。已有360人学习，适合需要熟悉魔灯平台基础操作、搭建课程内容或开展在线互动教学的高校教师、培训人员与课程管理者参考。

1. 从一本讲资源的手册说起：Moodle 课程页里那四个“放内容的地方”到底怎么选

接手一门要上线到 Moodle 的课程时，最先卡住人的常常不是服务器和账号，而是编辑状态下那排图标：文本页、编写网页、链接到文件或站点、插入标签，四个看着都像“放内容的地方”。这份使用说明把资源、程序教学与测验、BBS 与投票、WIKI 四块按操作顺序铺开，每一步都标了界面位置和参数含义，读起来更像一本能边做边翻的施工手册，而不是功能清单。它适合两类人：第一次把线下课件搬进在线学习平台、又不想把课程页做成文件夹堆的老师；以及要给一批课程做统一模板、必须把参数讲清楚的课程管理员。下面按我实际搭课的次序，把这份说明里真正用得上的部分拆开。

2. 资源入口与四类资源选型：文本页、编写网页、文件链接、标签各自管什么

2.1 先分清“资源”和“活动”，再动手点图标

进入课程后点右上角【打开编辑功能】，每个区块底部会出现“添加一个活动或资源”，点图标右侧的箭头才会展开完整类型列表。这一步很多人只看到默认几个图标就以为资源就这些，其实是列表没展开。

判断该用资源还是活动，我用一条很土的标准：有没有学生动作、有没有分数进成绩册。纯展示——学习目标、课件、参考资料、单元导语——走资源；需要学生提交、选择、作答、互评——走活动。资源不产生成绩，活动通常产生成绩，这条线划错了，后面成绩册里就会出现一堆对不上的条目。

资源的通用编辑页结构是固定的三块：名称、概要、正文（不同资源叫法略有差别）。名称是课程页上学生看到的链接文字，概要默认只在展开时显示，正文才是主体。保存按钮一般有三个：保存并返回课程、保存并显示、取消。搭课阶段我基本只用“保存并显示”，因为能立刻看到学生在课程页上看到的样子。

2.2 文本页的三种格式：自动格式、纯文本、Markdown

文本页是最省事的资源，但说明里那张“格式选择”的下拉框是翻车高发区。三个选项的差别不在“好不好看”，而在段落怎么断、符号怎么解释：

• Moodle 自动格式：按你编辑时的段落走，空行分段，表情符号代码会渲染成图形。绝大多数课程通知、学习目标都该用这个，也是默认值。
• 纯文本格式：段落照样保留，但表情代码、HTML 标签原样显示成字符。贴代码片段、贴需要精确对齐的表格文本、贴公式原文时用它，配合<pre>标签能保住缩进。
• Markdown 格式：靠#、*、>这类标记控制结构，表情会渲染，但分段完全依赖空行。说明里写“不分段落显示”，实际意思是不按你敲的回车断行——很多人写成一大坨就是这个原因。

我一般只改一件事：把“显示设置”里的窗口方式从默认的“自动”改成“嵌入”或“弹出”。自动模式下 Moodle 会自己判断，有时在学生端弹出新窗口，有时又内嵌，同一门课里表现不一致，学生就会来问“为什么这个链接点开是新的”。统一成一种，问的人立刻少一半。

“常见模块设置”里还有一个“对学生是否可见”，默认“显示”。草稿阶段的资源我习惯先设“隐藏”，等内容、附件、显示设置都确认过再放开——比先发后改省事，也不会在学生端留下修改痕迹。

2.3 编写网页和链接到文件：一个存数据库，一个存文件

编写网页用的是 WYSIWYG 编辑器，能写完整的单页 HTML，支持大部分 HTML 与 JavaScript 能力。它的关键特征是内容存在数据库里，不在课程文件区。带来两个后果：一是这类页面在“文件”里找不到，备份还原时跟着课程走但没法单独拷出来复用；二是页面里的相对路径引用不了课程文件，要引图片得用绝对地址或者干脆上传到别处。

链接到文件或站点是三种来源合一：从本机上传新文件、选课程文件区里已有的文件、填一个外部网址。文件区是可以管理的——文件名前有复选框，能全选、移动、删除、打成压缩包；上传的网页还能直接点进去在线改。

这里有个特别容易犯的错：填“来自”那个输入框时，有人会把本机路径（C:\课件\第一讲.ppt）或者内网地址直接粘进去。学生点开必然报错，而且报错信息很难懂。正确做法是点旁边的“选择或上传文件”按钮，从文件选择器里挑，路径由系统自己生成。

反过来，外部站点链接一定要用完整 URL，并且用没登录过校园网的手机流量测一次。校内能开、校外打不开的外链，在线课程里等于失效。

2.4 插入标签与显示设置：把课程页的层次感做出来

标签不生成独立页面，它就贴在课程主页的区块里，只放文本和图片。作用是把一长串资源切成几段：单元标题、周次分隔、图标条、一句导语。

正因为标签不是独立页面，它在“资源”报告里看不到，学生也不会产生点击记录。所以别把考核说明、截止时间这类关键信息只写进标签——学生复习时翻资源列表是找不到的。这类信息我一般放文本页，标签只做视觉引导。

标签里放图片要注意尺寸。课程页区块宽度有限，横版大图会被压扁或者撑出滚动条，我一般先裁到 800 像素宽以内再上传。

3. 程序教学（课）模块：问题页、分支表和跳转规则怎么搭出一条能跑的学习路径

3.1 三种程序教学流程，对应到“课”模块里是什么结构

说明里把程序教学分成直线式、分支式、莫菲尔德三种，这三种在纸上是教学法概念，落到 Moodle 的“课”模块里其实是三种页面连法：

直线式——一串问题页，答对进下一页，答错留在本页或退回上一页。学生必须按顺序走，不能跳步。适合知识点有强前后依赖的内容，比如语法点、公式推导。

分支式——问题页答错后跳到专门的补救页，补救页学完再回到主序列。学生走的是“主支 + 支线”的结构，不同水平的学生路径不同。

莫菲尔德——只有一条主序列和一条支序列，支序列学完不回原点，直接进入主序列的下一题。这是前面两种的折中：既有补救，又不让学生重复走已经过的路。

Moodle 的“课”模块提供两种页面类型来支撑这套结构：

• 问题页：呈现一个问题，学生必须作答，系统判断对错，可以计分，答题后显示你预先写好的反馈。
• 分支表：只给学生几个选项让他选，没有对错，不计分，纯粹用来控制走向。

所以一条完整路径 = 问题页（判断）+ 分支表（分岔）+ 每个页面上的“跳转到”（连线）。缺任何一环，路径都是断的。

3.2 建课参数：分数规则必须在加页面之前定死

在【添加一个活动】里选“程序教学”，进去先看到的是一屏参数。这些参数不是走过场，改晚了会牵连已经产生的成绩记录。

关于“计时”有个细节值得提前说清楚：说明里明确写了，计数器时间用完不会把学生踢出课程，只是之后回答的题不算数，而数据库里的时间是在学生每次作答时才检查的。所以它不是考试防作弊工具，别指望靠它卡住超时提交。

“最多有几个答案/分支”这一项，说明里给的结论是可以改，而且对已有内容的课改了也不会出问题；但要加一个选项特别多的问题或者很长的分支表，就必须先把这个值调大，加完再调回标准值。我踩过一次：默认 4，硬要加第五个选项，界面上根本出不来输入框，找了一下午以为是权限问题。

3.3 从问题页到分支表：一条带补救支线的完整搭法

下面按说明里的例子走一遍：一道选择题答错进补救页，答对进下一题；一道填空题答错回本页重答。

第一步，建好课之后进入编辑状态，点【添加问题页】，题型里选“选择题”，填题干和选项。系统默认第一个选项是正确答案，这一点必须先记住再填，否则整套跳转都会反。选项顺序在学生端是被打乱的，所以不用担心“正确答案永远是 A”被学生摸出来。

第二步，给每个选项写反馈。选 interest 的给一句“作名词表示兴趣，这里需要形容词”，选 interested 的给“主语是人时用 be interested in，这里主语是物”。反馈不是装饰，分支式教学里它就是补救内容的第一层。

第三步，给选项设“跳转到”。正确选项跳到下一题所在的问题页，错误选项跳到后面要建的补救分支。每个选项一行下拉框，别留空。

第四步，回到问题页，点【添加分支】建分支表页面。分支表本身不计分、不判对错，它只提供一个入口和几个选项。分支表页面上的选项同样要设“跳转到”，通常是跳回主序列的下一题。

第五步，加第二道题，类型选“填空题”。“正确答案”字段里一行写一个可接受答案，大小写和空格的处理按你的教学要求来；错误答案可以单独给回应，比如学生填 the 就给一句“这里泛指，用不定冠词”。

第六步，回头检查问题一的跳转是否指向了正确的问题页。用页面上的【检查此页面】预演，选不同选项看落到哪一页。这一步不能省，因为跳转下拉框里有一堆选项：下一页、上一页、本页、结束课、未看到的页面、随机页面、具体页面名。选“下一页”看着省事，实际会随页面顺序变化而改变走向，我一般全部显式指定页面名。

3.4 试跑验收：把每一条边都走一遍

搭完不等于能跑。我的验收方式是拿一个学生账号，从课程入口进去，按下面这张表逐条走：

跑完之后再看成绩册里这门课有没有记录、最高分值是不是你设的那个数。程序教学的分数是按页面累计的，中途改参数，已经产生的记录不会自动重算，这一点在第五章还会展开。

4. 测验、BBS、投票、WIKI：形成性评价与课堂互动的四件套

4.1 测验：先建题库，再组卷

测验和程序教学最大的区别是：程序教学按路径走，测验按题目集合走。所以测验的准备工作不在“加活动”，而在题库。

题库按分类管理，一门课建议按章节或知识点建分类，题目建在分类里而不是直接建在测验里。这样做的好处是同一道题可以被多份试卷引用，改一次全生效，不用逐份卷子去改。题型常用的是选择题、填空题、匹配题、判断题、完形填空、数字题、简答与作文。

每道题有几个参数要留意：默认分值、通用反馈、每个选项的反馈。通用反馈在“回顾”区域显示，选项反馈在选了该项之后显示，两者分工不一样——通用反馈讲知识点，选项反馈讲“你为什么会选错”。

组卷时的三个开关：随机题（从分类里抽若干道）、题目顺序打乱、选项顺序打乱。随机题是防抄袭最有效的手段，但前提是题库里题量够，抽 10 道至少要有 40 道备选，否则重复率还是高。

评阅与回顾选项决定学生什么时候能看到什么：答题中、提交后立即、关闭后、仅在关闭后。默认设置下学生能在提交后立刻看到正确答案，考试场景要关掉。这项不改，第一次考试就会出现“先交的人把答案传出去”的情况。

其他要设的：开放与关闭时间（决定能不能进）、时间限制（决定做多久）、允许的尝试次数、评分方法（最高分/平均分/第一次/最后一次）、是否要求密码、分组与分组隔离。测验这块说明里篇幅不大，但真正出事的基本都在这几个参数上，不在这几个参数上出事的，都在题库结构上。

4.2 BBS（论坛）：版式选错，后面全是补救

论坛的四种版式各有明确用途，选错之后改版式会丢掉已有讨论的展示结构，所以一开始就要定：

• 单一简单讨论：全课只有一条主线，所有人回在一条线上。适合发通知、课程公告，配合强制订阅效果最好。
• 每个话题一个讨论：学生可以自己开新话题。适合答疑区、经验分享区。
• 问答论坛：学生发问后，必须自己先给出一个答案才能看到别人的回答。适合把“我先看看别人怎么写的”这种心理堵住。
• 一般用途的标准论坛：博客式，可以带附件、评分。适合需要提交作业并互评的场景。

订阅模式要特别注意。可选、强制、自动、关闭四种设置里，“强制订阅”会给所有参与者发邮件。如果站点邮件没配好，或者用的是不能发信的发件地址，结果是学生收不到、老师以为发了。上线前一定用一个真实邮箱测一封。我见过最典型的翻车是：课程里开了强制订阅，邮件服务器其实一直没通，两周后才发现没人收到过通知。

论坛评分要用的话，聚合类型选平均、计数、最大、最小或总和中的一个，再限定评分的时间范围。聚合类型是“计数”时，学生刷帖就能拿分，所以要么配最低字数限制，要么干脆用人工评分。

4.3 投票（Choice）：一次一问的最小互动

投票是所有这些活动里配置最少的：一个问题、若干选项、几个开关。

• 单选/多选：允许多选时要限制最多可选几项，否则学生全勾一遍。
• 匿名：开启后不记录用户名，只统计结果。做敏感话题摸底时用。
• 显示结果：不显示、显示、匿名后显示、始终显示。教学场景里“匿名后显示”最实用——学生投完才看到分布，避免从众。
• 是否允许更新选择：允许更新适合收集意见，禁止更新适合表决。

投票默认不进成绩册。要计入成绩，就得改设置里的评分项，或者用反馈活动替代。我一般的用法是：课前摸底用投票、不计分；随堂检测用测验、计分。两个目的混在同一个活动里，最后两头都不好用。

4.4 WIKI：把“小组共写”这件事落到可追溯的页面上

WIKI 的三种模式决定了协作的粒度：

• 协作编辑：所有人共写同一套页面，谁都能改。
• 个人 WIKI：每人一套自己的页面，互不可见。
• 单成员 WIKI：只有你指定的一人能编辑，其余人只读。

首次创建时有个必填的“首页名”，很多人留空，结果进去是一片空白，以为功能坏了。首页名其实就是起点页面的标题，随便给个“术语表首页”或者“项目文档”都行。

格式选项有 HTML、Creole、Nuke 几种，教师不熟标记语言就选 HTML 配 WYSIWYG 编辑器，学生端不需要额外学习成本。每次编辑都会留修订记录，谁改了哪一版、改了什么都能翻出来，这也是 WIKI 相比“上传 Word 到文件区”最实在的价值。

5. 避坑与排查：五条从现场收回来的翻车记录

5.1 文本页写得好好的，学生端全挤成一段

现象：编辑页里分段分得清清楚楚，保存后学生看到的是一整坨文字，表情符号也没变成图形。

原因：两件事叠在一起。一是格式选成了 Markdown，而 Markdown 靠空行分段，敲回车不生效；二是选成了纯文本格式，表情代码只能原样显示。

解决：非必要不改格式，保持默认的“Moodle 自动格式”。确实要用 Markdown，就在段与段之间敲一个空行；贴代码、贴公式用纯文本格式，外面包一层<pre>保住缩进。改完用学生账号看一眼，别在编辑页里判断。

5.2 链接到文件或站点，学生点开报错

现象：老师在自己电脑上点开正常，学生点开是空白页或者错误提示。

原因：常见的就三种。一是在“来自”输入框里手工粘了本机路径；二是外部网址填的是内网地址或者带登录态的相对路径；三是上传了文件但没在文件选择器里选中，链接指向了一个空位置。

解决：一律通过“选择或上传文件”按钮进文件选择器挑，让系统自己生成路径。外部链接用完整 URL，并且用手机流量测一次，确认校外可访问。上传完先在文件区点一下文件名，能预览再挂到课程里。

5.3 程序教学答错之后来回打转

现象：学生选错选项，跳到补救页，补救页学完又回到原题，再错再回，永远出不来。

原因：补救分支页面的“跳转到”设成了“上一页”或者指向问题页本身；也可能是分支表页面的选项根本没设跳转，落到了默认行为上。说明里那句话值得贴墙上——页面上每一个跳转点都要显式指定。

解决：补救页的跳转显式指向主序列的下一题，不要用“上一页”“下一页”“结束课”这类相对选项。搭完用【检查此页面】把每条边都走一遍，学生账号再走一遍，两边都过才算完。

5.4 改了分数规则，成绩册纹丝不动

现象：把“最高分值”从 0 改成 60，学生成绩还是没出现；或者允许重学之后，成绩册里只留了一次分数。

原因：有三处会直接影响成绩落不落进成绩册。最高分值为 0 时这门课不出现在任何成绩页面；“实践课”选“是”时同样不进成绩册；“如何处理多个成绩”决定了重学后取平均、最高、第一次还是最后一次。

解决：这三项要在加页面之前定死。已经上线又必须改的，改完让学生重新作答触发重算，或者手动重算成绩。上线前我做一件事：随便找一个学生账号做完，去成绩册确认条目真的出现了。

5.5 开了强制订阅，没人收到过通知

现象：论坛设成强制订阅，公告发出去，学生反馈没收到邮件。

原因：站点邮件通道没配通，或者发件地址是不能发信的那种；也可能是学生账号的邮箱是批量导入的假地址。另一个隐藏原因是分组论坛设了分组隔离，跨组的学生本来就看不同内容。

解决：先给自己发一封测试；检查发件地址是否有发信权限；分组论坛上线前确认“可见分组”设置和分组归属。答疑区用问答论坛，因为它在学生作答前不显示别人的答案，能省掉很多“照着抄”的纠纷。

6. 上线前的最后一公里：备份、还原与抽样回归的检查表

课程搭完，真正决定它能不能安稳跑一学期的，是备份和回归这两件事，不是页面好不好看。

备份我走界面：课程管理里的“备份”，把资源、活动、成绩、用户数据、分组这些勾上，生成一个.mbz包。这个包的用途不只是留底，更是跨课程复用的载体——编写网页类资源存在数据库里，你在文件区找不到它，只能靠整课备份还原到另一门课里再删改。

还原比备份容易出事。还原到同一站点的另一门课，要选“还原到新课程”而不是“覆盖当前课程”；跨站点还原要先确认目标站点的模块版本对得上，低版本往高版本走通常没问题，反过来经常缺模块。

还原完我固定跑两条命令清缓存和补任务，不然新页面可能不出现、订阅邮件可能不发出：

# 进入 Moodle 站点根目录 cd /var/www/moodle # 清缓存，还原后课程页不刷新多半是这里没做 php admin/cli/purge_caches.php # 手动跑一次定时任务，把邮件、完成度、成绩重算等挂起任务推掉 php admin/cli/cron.php

这两个脚本要用运行 Web 服务的同一个系统用户执行，用 root 跑出来的文件属主不对，后面上传附件会报权限错误——这是我最常返工的一处。

最后是抽样回归，我不看全量，只看这张表里的六项：

这套流程是被逼出来的。早些年我图快，课程搭完直接在编辑状态下点了一遍就算验收，结果开学第一天学生反馈“第三章点进去是空白”，查了半天是文件链接指向了没上传成功的残留记录。从那以后我每次上线前都强制走一遍：备份 → 还原到测试课程 → 学生账号抽样六项 → 清缓存跑定时任务，一条不落。希望帮到你。

本文还有配套的精品资源，点击获取