使用npm start运行克隆的GitHub医疗寻呼聊天应用报错如何解决？

1. 基础环境校验 #

首先确认本地Node.js版本匹配项目要求，该项目适配的Node版本为14.x ~ 16.x，过高的Node版本（如18.x及以上）会出现依赖兼容报错。可通过node -v查看当前版本，版本不匹配建议使用nvm进行版本切换。

2. 依赖安装操作 #

克隆项目到本地后，不要直接执行启动命令，先完成依赖安装：

• 进入项目根目录，执行npm install安装全部依赖
• 若安装过程中出现依赖版本冲突报错，执行以下命令重新安装：

# Mac/Linux环境
rm -rf node_modules package-lock.json
# Windows环境
rd /s /q node_modules
del package-lock.json

# 重新安装依赖
npm install --legacy-peer-deps

3. 环境变量配置 #

该项目需要自定义环境变量才能正常运行，缺失配置会直接导致启动失败：

• 找到项目根目录下的.env.example文件，复制一份并重命名为.env
• 按照文件内的注释填写对应的必填配置项，保存后再执行启动操作

4. 正常启动应用 #

完成上述步骤后，执行npm start启动项目，默认会在3000端口运行，启动成功后直接在浏览器访问http://localhost:3000即可。

常见异常处理 #

• 若提示3000端口被占用：可先终止占用端口的进程，或者修改启动端口，Windows环境执行set PORT=3001 && npm start，Mac/Linux环境执行PORT=3001 npm start
• 若出现node-sass相关报错：执行npm rebuild node-sass重新编译对应版本的依赖即可

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