Mix CSS版本哈希变化？mix.version()使用-php教程-PHP中文网

根本原因是 mix.version() 未正确启用或未在生产环境执行，导致文件名无哈希、url 不变、浏览器复用旧缓存；需确认 webpack.mix.js 含 .version()、运行 npm run production、blade 中使用 mix() 函数且路径匹配 manifest 键名。

mix css版本哈希变化？mix.version()使用

你在 Laravel 项目中修改了 CSS 文件，但浏览器仍加载旧样式，说明资源路径未触发缓存失效——根本原因是 mix.version() 未正确启用或未在生产环境执行，导致文件名无哈希、URL 不变、浏览器复用旧缓存。

确认 mix.version() 是否已启用

打开项目根目录下的 webpack.mix.js 文件，检查是否在链式调用末尾添加了 .version()。例如：

mix.js('resources/js/app.js', 'public/js')<br>  .sass('resources/sass/app.scss', 'public/css')<br>  .version();

若缺失该行，则哈希文件名和 mix-manifest.json 都不会生成，mix() 函数将退化为返回原始路径，且不报错。

注意：Laravel 9+ 默认配置可能已含 .version()，但若你手动删过或在开发环境误删，需手动补回。

必须在 production 模式下运行才能生成哈希文件

执行 npm run production（不是 npm run dev 或 npm run build）。

这一步会触发三件事：编译资源 → 重命名输出文件（如 css/app.css?id=8a3f2d）→ 生成 public/mix-manifest.json 映射表。

如果只跑 npm run dev，.version() 不生效，manifest 文件为空或不存在，mix() 在 Blade 中将返回空字符串或 404。

CI/CD 部署时，务必确保构建阶段包含 npm ci && npm run production，而非仅拷贝源码。

Blade 中必须用 mix() 引入资源

在模板中替换所有硬编码路径：

❌ 错误写法：<link rel="stylesheet" href="/css/app.css">

✅ 正确写法：<link rel="stylesheet" href="%7B%7B%20mix('css/app.css')%20%7D%7D">

CSS婚礼策划服务机构宣传网站模板

CSS婚礼策划服务机构宣传网站模板是一款适合提供婚礼策划和婚庆服务机构宣传网站模板下载。提示：本模板调用到谷歌字体库，可能会出现页面打开比较缓慢。

下载

mix() 函数不读取文件内容，只查 mix-manifest.json 中的键值映射。若 manifest 里没有 /css/app.css 这个 key，就返回空。

确保传给 mix() 的路径与 webpack.mix.js 中输出路径一致：比如你输出到 public/css/app.css，那么 mix() 中必须写 'css/app.css'，不能写 '/css/app.css' 或 'assets/css/app.css'。

排除 copy() 导致 version 失败的隐藏陷阱

如果你在 webpack.mix.js 中使用了 mix.copy()，尤其源路径含英文点号（如 'resources/assets/js/lib/editor.md'），mix.version() 会直接报 EISDIR 错误并中断构建。

方法一：将带点的目录名改写为连字符，例如 editor-md 替代 editor.md；

方法二：把 copy 操作移到 .version() 之后，并用 .then() 包裹（实测有效）：

mix.sass('resources/sass/app.scss', 'public/css')<br>  .version()<br>  .then(() => {<br>    mix.copy('resources/assets/js/lib/editor-md', 'public/lib/editor-md');<br>  });

该问题源于 Laravel Mix 内部对含点路径的 fs.readSync 调用异常，非配置错误，但极易卡住整个版本化流程。