Live Server运行故障求助：启动项目时持续显示空白目录页

1. 检查项目入口文件与启动配置 #

• 确认项目根目录存在对应技术栈的标准入口文件：前端项目找index.html，Node.js项目找server.js/app.js，Python Flask项目找app.py等
• 查看项目启动命令配置，比如前端项目的package.json中scripts字段：

  "scripts": {
    "start": "vite" // 确保启动命令指向正确的开发服务逻辑
  }
  

• 若用Apache/Nginx部署，检查服务器配置里的DocumentRoot是否指向项目的正确输出目录（如前端打包后的dist/build文件夹）

2. 验证路由与服务响应逻辑 #

• 前端单页应用（SPA）需确认路由 fallback 配置：比如React项目要保证public/index.html是所有路由的入口，或在服务器配置中设置重定向规则
• 后端项目检查根路径是否有响应处理，比如Express项目：

  app.get('/', (req, res) => {
    res.send('项目正常启动'); // 确保根路径能返回内容
  });
  

3. 确认服务器启动状态与端口占用 #

• 启动项目时紧盯终端输出，排查是否有端口占用、依赖缺失等报错信息
• 检查端口占用情况：Windows用netstat -ano | findstr :端口号，Mac/Linux用lsof -i :端口号，结束占用进程后重启项目

4. 清理缓存与重新安装依赖 #

• 用Ctrl+Shift+R强制刷新浏览器，清除旧缓存页面
• 删除项目的node_modules（前端）或虚拟环境（Python），重新执行npm install/pip install -r requirements.txt，确保依赖完整

5. 检查服务器目录浏览开关 #

• 部分开发服务器在找不到入口文件时会默认显示目录列表，比如Node.js的http-server需添加-o index.html参数指定入口，避免目录页展示

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