Mumble Web本地运行代码及Demo应用遇到的问题求助

1. Demo应用的源码位置 #

Demo的核心源码位于仓库根目录，app文件夹是构建后生成的静态资源目录（也包含开发阶段未编译的ES模块代码，因此直接打开其中的index.html会触发模块语法错误）。

2. 本地安装所有依赖的步骤 #

针对Windows 11环境，结合你提供的Node.js版本，按以下步骤操作：

• 切换Node.js版本至14.21.2（该版本对仓库依赖兼容性更好）
• 清理npm缓存：执行 npm cache clean --force
• 打开仓库根目录的package.json，删除其中的prepare脚本（该脚本在Windows环境下易触发安装报错）
• 执行 npm install 完成依赖安装

3. 本地运行Demo应用的方法 #

方法一：开发模式（带热重载） #

• 依赖安装完成后，执行 npm run watch
• 若无法访问localhost:8080，排查点：
  • 检查端口8080是否被占用，可尝试指定其他端口：npm run watch -- --port 8081
  • 查看控制台输出，确认开发服务器是否正常启动（无报错信息）
• 服务器启动后，在浏览器中访问对应的地址（如http://localhost:8080）即可使用Demo

方法二：生产构建后运行 #

• 执行 npm run build 构建生产版本的静态资源（产物会输出到app文件夹）
• 安装静态文件服务器：npm install -g serve
• 运行静态服务器：serve app
• 访问控制台输出的地址即可打开Demo

内容的提问来源于stack exchange，提问作者Jabal Logian