# 为什么静态网站部署需要 index.html 文件？

Canonical URL: https://help.iagenify.com/zh/faqs/hosting/index-html

[← 返回托管常见问题](https://help.iagenify.com/zh/faqs/hosting)

帮助中心 · 常见问题 托管 1 分钟阅读
# 为什么静态网站部署需要 index.html 文件？
访客打开网站根路径时，托管服务需要提供一个入口文档。IaGenify 的静态部署要求包含 `index.html`；如果缺少该文件，部署会被拒绝，无法发布为可用网站。
IaGenify
托管

## 提供网站入口文件
浏览器请求不带文件路径的主机名时，托管服务需要返回默认文档。静态网站通常使用 `index.html` 作为入口，并由它引用或加载页面的其他资源。
仅上传图片、脚本或嵌套页面，并不能说明根路径应显示什么内容。
请将 `index.html` 以正确名称放在部署文件集的根目录。如果构建工具把文件输出到 `dist` 或 `out` 等目录，请部署该目录的内容，并确认入口文件位于最上层。
上传项目的父目录可能多出一级目录，导致入口文件无法被找到。
## 检查已部署根目录和资源路径
部署前检查文件列表，确保入口文档引用的资源在上传后确实存在。本地可用的路径如果带有本机目录前缀，或假设了不同的基础 URL，发布后可能失效。已部署目录结构应与 HTML 中的引用相匹配。
部署后打开网站根 URL，并在失败时检查浏览器响应。根路径返回 404 可能表示入口文件缺失或位置错误；页面能打开但没有样式，则可能是资源路径失效。
修正构建输出或所选部署目录后重新部署，并同时检查根页面和一个有代表性的资源 URL。 [← 返回托管常见问题](https://help.iagenify.com/zh/faqs/hosting)