Laravel不集成前端，仅提供工具链；新项目用Vite，老项目或需Webpack深度控制时用Mix；静态资源须经构建输出至public目录，Blade中用@vite或mix()引入，严禁硬编码路径或直引node_modules。
直接说结论：Laravel 本身不“集成前端”，它只提供构建前端的工具链和运行环境；你选 Vite 还是 Mix，取决于项目阶段和团队习惯——新项目用 vite，老项目或需深度 Webpack 控制的用 laravel-mix，别硬套。
Blade 模板里怎么正确引入 JS/CSS 文件
所有静态资源必须放在 public/ 目录下，或由构建工具（Vite/Mix）编译后输出到该目录，否则浏览器 404。
-
<script src="/js/app.js"></script>只在开发时“看起来能跑”，但上线后若没走构建流程，文件根本不存在 - 用
@vite(['resources/js/app.js', 'resources/css/app.css'])替代硬编码路径，它会自动注入开发时的 HMR 脚本或生产时带哈希的文件引用 - 如果坚持用
mix()，Blade 中必须写{{ mix('js/app.js') }}，且确保部署时public/mix-manifest.json文件已上传 - 千万别在 Blade 里写
<script src="node_modules/moment/min/moment.min.js"></script>——node_modules不在public下，Nginx/Apache 根本不认
Vite 和 Mix 在实际项目中怎么选
不是谁更“高级”，而是谁更贴合当前工程节奏。Vite 是默认推荐，但 Mix 并未淘汰，尤其在已有 Webpack 配置沉淀的项目里。
- 新 Laravel 9+ 项目：直接用
vite，npm run dev启动快、热更新准、CSS/JS 拆分天然支持，resources/js/app.js是唯一入口 - 老项目升级或需要自定义 Webpack 插件（如特定 loader、legacy bundle）：继续用
laravel-mix，但别碰mix.webpackConfig({})全量覆盖，容易丢掉@别名等关键配置 - 混合场景（比如部分页面用 Vue，部分用 Livewire）：Vite 更友好，因为
@vite指令可条件性插入，而 Mix 的mix()在服务端渲染时无法动态判断是否加载某 chunk - CI/CD 流水线要改：Vite 构建产物默认在
public/build/，Mix 默认在public/下平级，Nginx root 或 CDN path 需同步调整
第三方库（比如 moment.js）怎么安全引入
核心原则：不手动拷文件，不直引 node_modules，让构建工具统一处理依赖和打包。
立即学习“前端免费学习笔记（深入）”；
- 在
resources/js/app.js里import 'moment'，Vite 或 Mix 会把它打进 bundle，不用管路径问题 - 如果只想局部用（比如仅某个 Vue 组件），就在组件内
import moment from 'moment'，配合defineAsyncComponent可实现懒加载 - 避免全局挂载
window.moment = require('moment')—— 破坏模块作用域，Tree Shaking 失效，体积变大 - 用 CDN 是权宜之计（
<script src="https://cdn.jsdelivr.net/npm/moment@2.29.4/min/moment.min.js"></script>），但失去版本锁定和离线能力，不适合生产环境长期依赖
最容易被忽略的是构建产物与部署路径的一致性：Vite 的 base 配置、Mix 的 mix.setPublicPath()、Nginx 的 root、PHP 的 APP_URL，这四个地方只要一个对不上，@vite 或 mix() 返回的 URL 就会指向 404。检查顺序建议：先看浏览器 Network 面板里请求的 URL 是什么，再反推哪一层配错了。
