应选alias：当URL路径与磁盘目录名不一致时，alias可替换location匹配前缀，如/img/→/data/code_img/；选root则要求结构对齐，如/static/→/var/www/下必须存在static子目录。

图片加载 404，八成是 root 和 alias 混用了，或者配错了路径拼接逻辑。关键不是“哪个更好”，而是“哪个符合你的 URL 和磁盘结构关系”。

先看问题出在哪：root 会追加，alias 会替换

假设你想通过 http://example.com/img/1.png 访问服务器上 /data/code_img/1.png 这个文件：

• 用 root /data/code_img; + location /img/ { ... } → Nginx 实际找的是 /data/code_img/img/1.png（多了一层 img/）→ 404
• 用 alias /data/code_img/; + location /img/ { ... } → Nginx 实际找的是 /data/code_img/1.png（把 /img/ 整段替换了）→ 成功

什么时候该用 root

适合 URL 路径和磁盘目录结构完全对齐的场景：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• 整个站点静态资源放在 /var/www/dist/，想让 / 直接对应 index.html：
  location / { root /var/www/dist; }
• 图片都在 /var/www/static/images/，且 URL 就是 /static/images/xxx.jpg：
  location /static/images/ { root /var/www; }（注意：root 值不带 static/images）
• root 值末尾加不加 / 都行，Nginx 会自动处理，但建议统一写成 /var/www/ 更清晰

什么时候该用 alias

适合 URL 路径和磁盘目录名不一致、需要“映射跳转”的场景：

• 磁盘路径是 /mnt/pics/，但你想用 /img/ 这个 URL 访问：
  location /img/ { alias /mnt/pics/; }（alias 值必须以 / 结尾）
• 挂载 Swagger UI 到 /api/docs/，而文件实际在 /opt/swagger-ui/：
  location /api/docs/ { alias /opt/swagger-ui/; }
• 子应用部署，比如把 /admin/ 映射到 /srv/my-admin/，且希望 /admin/index.html 直接读 /srv/my-admin/index.html

常见踩坑点

这些细节错一个，就 404：

• alias 值漏掉末尾 /，比如写成 alias /data/code_img; → 请求 /img/1.png 会变成 /data/code_img1.png（少斜杠，路径错）
• location 写成 /img（无结尾 /），而 alias 是 /data/code_img/ → 请求 /img1.png 会被误拼为 /data/code_img1.png
• 同一 location 块里同时写 root 和 alias → Nginx 启动直接报错，不允许混用
• 用 root 时没检查磁盘是否存在对应子目录，比如 root /var/www; + location /static/ → 必须真实存在 /var/www/static/ 才能访问其下文件