本地Moodle4.2环境Grunt依赖冲突，求Node.js/Grunt重装兼容步骤

一、彻底卸载Node.js及残留文件（Windows系统） #

• 卸载Node.js：打开「控制面板」→「程序和功能」，找到Node.js右键卸载
• 删除残留目录：
  • 删除Node.js安装目录（默认是C:\Program Files\nodejs或C:\Program Files (x86)\nodejs）
  • 删除用户目录下的npm缓存和配置：删掉C:\Users\[你的用户名]\AppData\Roaming\npm和C:\Users\[你的用户名]\AppData\Roaming\npm-cache文件夹
  • 清理环境变量：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的Path里移除Node.js相关路径

二、安装Moodle 4.2兼容的Node.js版本 #

Moodle 4.2官方适配的是Node.js 16.x LTS版本，别装过高版本：

• 下载对应版本的安装包，默认安装即可
• 安装完打开PowerShell，输入node -v和npm -v，确认显示v16开头的版本号

三、清理Moodle项目里的旧依赖 #

进入你的Moodle目录D:\server\htdocs\moodle：

• 删除根目录下的node_modules文件夹
• 删除package-lock.json文件（如果存在）

四、安装适配的Grunt依赖 #

在PowerShell里进入Moodle根目录，依次运行以下命令：

• 安装项目依赖：npm install --legacy-peer-deps

  你之前遇到的ERESOLVE错误，是因为grunt-jsdoc@0.4.0只兼容grunt 0.4.x，但当前项目装了grunt 1.6.1，加--legacy-peer-deps就能跳过这个冲突，这是Moodle环境下的常规解决办法

• 全局安装Grunt命令行工具：npm install -g grunt-cli
• 验证安装：输入grunt -v，能正常输出版本信息就说明没问题

五、重建AMD文件 #

在Moodle根目录下运行：

• 直接重建：grunt amd，这个命令会重新生成所有损坏的min.js和min.js.map文件
• 如果想先清理旧文件再重建，先跑grunt clean，再跑grunt amd

注意：别乱运行npm audit fix #

npm audit fix会自动升级依赖，很容易破坏Moodle原本适配的版本环境，导致更多冲突。保持Moodle自带的package.json版本不变，用上面的--legacy-peer-deps安装就够了。

内容的提问来源于stack exchange，提问作者Mohammad Farouk