root指令定义静态文件根目录，Nginx将请求URI拼接到该路径后查找文件；可配置于http/server/location块，优先级location＞server＞http；与alias区别在于root是拼接URI，alias是替换URI前缀。
在 Nginx 中，
root
指令用于定义服务器响应请求时查找静态文件的**根目录**。它不直接指定某个 HTML 文件，而是设定一个基础路径，Nginx 会将请求的 URI（如
）拼接到该路径后，去查找对应文件。
root 的基本用法和路径拼接逻辑
root
的值是一个目录路径，Nginx 会把客户端请求的完整 URI（去掉 host 和 query string 后的部分）**追加到 root 路径末尾**来定位文件。
例如配置：
，用户访问
，Nginx 实际查找的文件是：
注意：URI 开头的
不参与拼接，只取其后路径部分
如果请求是
（首页），Nginx 会尝试查找
（前提是启用了
指令，默认包含 index.html）
常见配置位置与作用范围
root
可出现在
、
或
块中，优先级由高到低：
块中的
root
优先级最高，仅对该 location 生效
块中的
root
是该虚拟主机的默认根路径
块中的
root
是全局默认，通常不建议在此处设置，易被覆盖且缺乏灵活性
推荐做法：在
块设通用 root；对特殊路径（如 API 静态资源、上传目录）用
单独指定 root 或用
alias
（注意二者行为差异）。
立即学习
“
前端免费学习笔记（深入）
”；
root 与 alias 的关键区别
容易混淆的是
alias
—— 它替换整个匹配的 URI，而
root
是拼接 URI。
→ 请求
查找
→ 请求
查找
（
被完全替换）
因此，若只想让
对应某目录下的 HTML，用
root
更直观；若要映射某个 URI 前缀到完全不同的物理路径，
alias
更合适。
验证配置是否生效
修改配置后务必检查并重载：
运行
确认语法正确
执行
或
用
查看响应头，或直接访问页面观察是否返回预期 HTML
查看 Nginx 错误日志（通常在
）排查 404、403 等问题，确认路径是否真实存在、权限是否正确（Nginx 工作进程需有读取权限）
/index.htmlroot /var/www/html;https://example.com/about/team.html/var/www/html/about/team.html///var/www/html/index.htmlindexhttpserverlocationlocationserverhttpserverlocationlocation /static/ { root /data; }/static/css/app.css/data/static/css/app.csslocation /static/ { alias /data/; }/static/css/app.css/data/css/app.css/static//nginx -tnginx -s reloadsystemctl reload nginxcurl -I http://localhost//var/log/nginx/error.log