讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

index.html必须放在根目录下吗?

云芳小哥_5954

云芳小哥_5954

发布时间:2026-04-15 14:55:16

|

618人浏览过

|

来源于php中文网

原创

Web服务器默认查找index.html的路径是其配置的“服务根目录”(如Nginx的/var/www/html、Apache的DocumentRoot、Tomcat的webapps/ROOT/),而非绝对物理路径;该目录下存在index.html即能被/请求默认命中。

index.html必须放在根目录下吗?

不一定必须放在根目录,但“能被默认访问”这件事,取决于服务器是否把该文件所在路径识别为“可服务的根”。

Web 服务器默认查找 index.html 的路径是哪?

绝大多数 Web 服务器(Nginx、Apache、Tomcat、Vite 开发服务器、Vue CLI dev server)都遵循一个约定:当用户请求一个目录(比如 / 或 /admin/)时,会按顺序尝试查找该目录下的预设文件名,index.html 是其中最常见且通常排第一的候选。

关键点在于:这个“目录”是谁的根?

  • Nginx 默认服务根目录是 /usr/share/nginx/html 或 /var/www/html,你把 index.html 放进去,访问 http://localhost/ 就能命中
  • Apache 类似,看 DocumentRoot 配置,常见为 /var/www/html
  • Tomcat 的 WAR 包解压后,webapp/ 目录就是应用根,webapp/index.html 才对应 http://localhost:8080/
  • Vite 项目中,开发时 index.html 必须在项目根(即 vite.config.js 所在层),构建后它会被输出到 dist/index.html —— 此时 dist/ 才是实际服务根

放错位置导致 404 或空白页的典型场景

常见错误不是“文件放错了”,而是“服务没指向它”。比如:

立即学习“前端免费学习笔记(深入)”;

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载
  • 用 python3 -m http.server 启动静态服务时,当前工作目录就是根 —— 如果你在 src/ 里执行命令,那 src/index.html 才是 /;而你在项目根执行,就得把 index.html 放项目根
  • Vue CLI 项目中,修改了 public/index.html 才生效,改根目录下的 index.html 没用 —— 因为构建流程只读 public/ 下的模板
  • Nginx 配置了 location /app { root /opt/myapp; },那么真实根其实是 /opt/myapp,此时要让 http://site/app/ 显示页面,index.html 得放在 /opt/myapp/index.html,而不是 /opt/myapp/dist/index.html(除非你额外配 index index.html; 并确保路径映射正确)

想换位置又保持默认访问,该怎么配?

不挪文件,改配置更稳妥。核心就两条:

  • 告诉服务器“这个 URL 路径对应哪个物理目录”(root 或 alias)
  • 确认该目录下启用了 index 指令(Nginx 默认开启,Apache 需 DirectoryIndex index.html)

例如 Nginx 中,你想让 /dashboard/ 默认加载 /home/user/app/build/index.html:

location /dashboard/ {
    alias /home/user/app/build/;
    index index.html;
}

注意:alias 末尾的 / 必须和 location 末尾一致,否则路径拼接会出错 —— 这是 90% 的 404 根源。

真正容易被忽略的是:不同工具链对“根”的定义完全独立,index.html 的位置从来不是绝对的,而是相对于你启动服务时指定或默认的 serving root。盯住那个 root,比死记“必须放哪”有用得多。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7315

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4032

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3690

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

3699

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

5219

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3641

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3469

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2988

2023.09.01

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 237人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn