You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

执行npm run dev后页面空白求助:本地运行GitHub项目遇问题

解决本地运行resume项目空白页但编译成功的问题

我之前也碰到过类似的前端项目编译成功但浏览器打开空白的情况,给你几个实用的排查方向:

  • 检查浏览器控制台的运行时错误
    终端编译成功不代表前端运行时没有问题。按下F12打开Chrome开发者工具,切换到Console标签页,看看有没有JS报错(比如模块导入失败、变量未定义);再看Network标签,有没有资源加载404的情况——很多时候空白页是因为关键资源没加载到。

  • 确认访问地址与项目配置一致
    仔细看终端输出的启动信息,里面会有明确的访问地址(比如http://localhost:5173),确保你浏览器打开的是这个地址。如果项目配置了特定的base路径,比如构建工具里的base字段设为/resume/,那本地访问可能需要对应路径,或者开发环境下可以临时把base改成'/'试试。

  • 清理缓存后重试
    缓存问题经常导致这类奇怪的现象,试试这几步:

    1. 删除项目根目录下的node_modules文件夹和package-lock.json文件,重新执行npm install
    2. Ctrl+Shift+R强制刷新浏览器,跳过缓存加载页面
    3. 关闭当前的dev服务,重新执行npm run dev
  • 检查项目入口与挂载节点
    看看项目的入口文件(比如src/main.js)里有没有正确挂载应用:比如Vue项目里是否有app.mount('#app')这样的代码,同时确认index.html里存在对应的<div id="app"></div>节点——如果挂载节点不存在,应用就无法渲染,页面自然空白。

内容的提问来源于stack exchange,提问作者JUNJIE LIN

火山引擎 最新活动