简介Moodle使用说明是一份面向教师与在线课程建设者的平台实操文档重点解决课程资源创建、教学活动组织与平台功能上手等问题。压缩包内含1个doc文件约9.02MB以图文步骤和操作示例串联各功能模块便于按章节查阅与课堂实践。内容围绕资源添加与呈现展开涵盖文本页、编写网页、链接文件或站点、插入标签等资源类型并延伸至程序教学与测验、BBS与投票、Wiki等教学活动目录层次清晰。已有360人学习适合需要熟悉魔灯平台基础操作、搭建课程内容或开展在线互动教学的高校教师、培训人员与课程管理者参考。1. 从一本讲资源的手册说起Moodle 课程页里那四个“放内容的地方”到底怎么选接手一门要上线到 Moodle 的课程时最先卡住人的常常不是服务器和账号而是编辑状态下那排图标文本页、编写网页、链接到文件或站点、插入标签四个看着都像“放内容的地方”。这份使用说明把资源、程序教学与测验、BBS 与投票、WIKI 四块按操作顺序铺开每一步都标了界面位置和参数含义读起来更像一本能边做边翻的施工手册而不是功能清单。它适合两类人第一次把线下课件搬进在线学习平台、又不想把课程页做成文件夹堆的老师以及要给一批课程做统一模板、必须把参数讲清楚的课程管理员。下面按我实际搭课的次序把这份说明里真正用得上的部分拆开。2. 资源入口与四类资源选型文本页、编写网页、文件链接、标签各自管什么2.1 先分清“资源”和“活动”再动手点图标进入课程后点右上角【打开编辑功能】每个区块底部会出现“添加一个活动或资源”点图标右侧的箭头才会展开完整类型列表。这一步很多人只看到默认几个图标就以为资源就这些其实是列表没展开。判断该用资源还是活动我用一条很土的标准有没有学生动作、有没有分数进成绩册。纯展示——学习目标、课件、参考资料、单元导语——走资源需要学生提交、选择、作答、互评——走活动。资源不产生成绩活动通常产生成绩这条线划错了后面成绩册里就会出现一堆对不上的条目。资源的通用编辑页结构是固定的三块名称、概要、正文不同资源叫法略有差别。名称是课程页上学生看到的链接文字概要默认只在展开时显示正文才是主体。保存按钮一般有三个保存并返回课程、保存并显示、取消。搭课阶段我基本只用“保存并显示”因为能立刻看到学生在课程页上看到的样子。资源类型存放位置适合放什么不适合放什么文本页数据库学习目标、单元说明、短讲义、阅读提示需要排版表格、嵌入交互的内容编写网页数据库带表格/样式的单页、嵌 iframe、简单 JS 交互需要长期维护、要被别的课程复用的内容链接到文件或站点文件区 链接已有 PPT/PDF/视频、外部站点、打包好的网页需要学生在线编辑的内容插入标签课程页区块分节标题、图标条、单元导语、视觉分隔任何考核相关信息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 建课参数分数规则必须在加页面之前定死在【添加一个活动】里选“程序教学”进去先看到的是一屏参数。这些参数不是走过场改晚了会牵连已经产生的成绩记录。参数取值实际影响我的建议名称文本课程页上的入口名带周次或知识点别只写“课”计时是/否学生端显示 JS 计数器时间记入数据库只有限时练习才开时间限制分钟整数时间用完后作答不计入成绩与计时配套设置最多有几个答案/分支默认 4限制问题选项数和分支表分支数是非题可设 2内容已有也可以再调大实践课是/否选“是”则这门课不进成绩册纯练习、试讲用“是”定制分数是/否是每题单独给分可为正也可为负否整门课不计分有加权需求才开否则保持默认最高分值0–100设 0 则这门课不出现在任何成绩页面上线前一定确认不是 0允许学生重学此课是/否默认是控制能否多次学习资料型允许考试型禁止如何处理多个成绩平均/最高/第一次/最后一次重学后取哪次成绩与上一项一起定关于“计时”有个细节值得提前说清楚说明里明确写了计数器时间用完不会把学生踢出课程只是之后回答的题不算数而数据库里的时间是在学生每次作答时才检查的。所以它不是考试防作弊工具别指望靠它卡住超时提交。“最多有几个答案/分支”这一项说明里给的结论是可以改而且对已有内容的课改了也不会出问题但要加一个选项特别多的问题或者很长的分支表就必须先把这个值调大加完再调回标准值。我踩过一次默认 4硬要加第五个选项界面上根本出不来输入框找了一下午以为是权限问题。3.3 从问题页到分支表一条带补救支线的完整搭法下面按说明里的例子走一遍一道选择题答错进补救页答对进下一题一道填空题答错回本页重答。第一步建好课之后进入编辑状态点【添加问题页】题型里选“选择题”填题干和选项。系统默认第一个选项是正确答案这一点必须先记住再填否则整套跳转都会反。选项顺序在学生端是被打乱的所以不用担心“正确答案永远是 A”被学生摸出来。第二步给每个选项写反馈。选 interest 的给一句“作名词表示兴趣这里需要形容词”选 interested 的给“主语是人时用 be interested in这里主语是物”。反馈不是装饰分支式教学里它就是补救内容的第一层。第三步给选项设“跳转到”。正确选项跳到下一题所在的问题页错误选项跳到后面要建的补救分支。每个选项一行下拉框别留空。第四步回到问题页点【添加分支】建分支表页面。分支表本身不计分、不判对错它只提供一个入口和几个选项。分支表页面上的选项同样要设“跳转到”通常是跳回主序列的下一题。第五步加第二道题类型选“填空题”。“正确答案”字段里一行写一个可接受答案大小写和空格的处理按你的教学要求来错误答案可以单独给回应比如学生填 the 就给一句“这里泛指用不定冠词”。第六步回头检查问题一的跳转是否指向了正确的问题页。用页面上的【检查此页面】预演选不同选项看落到哪一页。这一步不能省因为跳转下拉框里有一堆选项下一页、上一页、本页、结束课、未看到的页面、随机页面、具体页面名。选“下一页”看着省事实际会随页面顺序变化而改变走向我一般全部显式指定页面名。3.4 试跑验收把每一条边都走一遍搭完不等于能跑。我的验收方式是拿一个学生账号从课程入口进去按下面这张表逐条走路径输入预期落点实际落点主序列第 1 题答对正确选项第 2 题待填主序列第 1 题答错干扰项补救分支页待填补救分支页选任意项任意主序列第 2 题待填第 2 题答对an结束课待填第 2 题答错the回到第 2 题待填跑完之后再看成绩册里这门课有没有记录、最高分值是不是你设的那个数。程序教学的分数是按页面累计的中途改参数已经产生的记录不会自动重算这一点在第五章还会展开。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 跑出来的文件属主不对后面上传附件会报权限错误——这是我最常返工的一处。最后是抽样回归我不看全量只看这张表里的六项检查项通过标准课程页首屏资源与标签顺序正确无隐藏项误显示文本页三种格式段落、符号、表情展示符合预期文件链接学生账号点开能正常下载或预览程序教学全路径每条分支都能走到终点不循环测验一次完整作答提交后成绩进成绩册回顾选项符合设置论坛与投票发帖可见、投票能提交、通知能收到这套流程是被逼出来的。早些年我图快课程搭完直接在编辑状态下点了一遍就算验收结果开学第一天学生反馈“第三章点进去是空白”查了半天是文件链接指向了没上传成功的残留记录。从那以后我每次上线前都强制走一遍备份 → 还原到测试课程 → 学生账号抽样六项 → 清缓存跑定时任务一条不落。希望帮到你。本文还有配套的精品资源点击获取