Nginx静态文件版本化发布通过目录隔离、符号链接和缓存协同实现：构建生成带哈希的版本目录，用current软链接指向当前版本，Nginx root指向该链接；发布时原子替换链接，HTML短缓存、哈希资源长缓存+immutable。
用 Nginx 实现静态文件的版本化发布，核心是让新旧版本共存、切换无感知、回滚可秒级完成。不靠覆盖文件，而靠目录隔离 + 符号链接 + 缓存协同，避免用户加载到混搭资源（比如新版 HTML 引用了旧版 JS）。
构建带版本号的静态目录结构
每次构建产物都生成独立版本目录，路径明确、互不干扰：
- /var/www/static/v1.0.0/ —— 含 index.html、app.a1b2c3.js、style.d4e5f6.css 等
- /var/www/static/v1.0.1/ —— 新构建产出，文件名含内容哈希
- /var/www/static/current → /var/www/static/v1.0.0 —— 指向当前生效版本的软链接
注意：所有资源路径在构建阶段就注入哈希（如 Webpack 的 contenthash），确保文件内容变则 URL 变，这是缓存可靠的前提。
Nginx 配置始终指向 current 软链接
在 server 块中直接使用 root 指向软链接路径，Nginx 自动解析目标目录：
location / {
root /var/www/static/current;
index index.html;
try_files $uri $uri/ =404;
}
无需开启 disable_symlinks，只要 Nginx worker 进程（如 www-data）对目标版本目录有读权限即可。软链接本身轻量、切换快、无 I/O 阻塞。
发布时仅原子替换软链接
上线新版本只需一条命令，毫秒级生效，无请求中断：
- 确认新目录完整可读：
ls -l /var/www/static/v1.0.1/ - 执行原子切换：
ln -sf /var/www/static/v1.0.1 /var/www/static/current - 所有后续请求立即命中新版本；旧版本目录保留，随时可切回
该操作在 Linux 文件系统上是原子的——不存在“链接悬空”或“半更新”状态。
配合缓存策略防止浏览器错用旧资源
仅靠目录切换还不够，必须让浏览器按需拉取新文件：
-
HTML 文件设短缓存：如
expires 1m;或Cache-Control: no-cache，确保能及时获取新入口 -
JS/CSS/图片等带哈希的资源设长缓存 + immutable：
expires 1y; add_header Cache-Control "public, immutable"; - 避免用
?v=xxx查询参数，CDN 或代理可能忽略它做缓存合并
这样既保证 HTML 快速更新，又让带哈希的资源长期缓存、免校验，兼顾速度与一致性。
