执行npm run dev后页面空白求助:本地运行GitHub项目遇问题
解决本地运行resume项目空白页但编译成功的问题
我之前也碰到过类似的前端项目编译成功但浏览器打开空白的情况,给你几个实用的排查方向:
检查浏览器控制台的运行时错误
终端编译成功不代表前端运行时没有问题。按下F12打开Chrome开发者工具,切换到Console标签页,看看有没有JS报错(比如模块导入失败、变量未定义);再看Network标签,有没有资源加载404的情况——很多时候空白页是因为关键资源没加载到。确认访问地址与项目配置一致
仔细看终端输出的启动信息,里面会有明确的访问地址(比如http://localhost:5173),确保你浏览器打开的是这个地址。如果项目配置了特定的base路径,比如构建工具里的base字段设为/resume/,那本地访问可能需要对应路径,或者开发环境下可以临时把base改成'/'试试。清理缓存后重试
缓存问题经常导致这类奇怪的现象,试试这几步:- 删除项目根目录下的
node_modules文件夹和package-lock.json文件,重新执行npm install - 用
Ctrl+Shift+R强制刷新浏览器,跳过缓存加载页面 - 关闭当前的dev服务,重新执行
npm run dev
- 删除项目根目录下的
检查项目入口与挂载节点
看看项目的入口文件(比如src/main.js)里有没有正确挂载应用:比如Vue项目里是否有app.mount('#app')这样的代码,同时确认index.html里存在对应的<div id="app"></div>节点——如果挂载节点不存在,应用就无法渲染,页面自然空白。
内容的提问来源于stack exchange,提问作者JUNJIE LIN




