laravel 5.2 elixir 在 mac 上的核心障碍是 node 版本不兼容（需 ≤7.x）、gulpfile.js 文件名大小写错误（必须为 gulpfile.js）及未正确 require('laravel-elixir')；node ≥8 会报 promise 错误，小写文件名或双引号 require 导致任务不识别，npm install 后须验证 node -e "console.log(require('laravel-elixir').version)" 输出 6.0.0-13。
Mac 下 Laravel 5.2 使用 Elixir 的核心障碍不是“装不上”，而是 gulp 找不到任务、elixir() 报错或编译后文件没生成 —— 大多数人卡在 Node 版本不兼容、Gulpfile.js 路径错位、或 Elixir 插件未正确 require 这三处。
确认 Node 和 Gulp CLI 版本是否匹配 5.2
Laravel 5.2 的 Elixir（v6.x）只支持 Node ≤ 7.x，Node 8+ 会直接报 ReferenceError: Promise is not defined 或 Cannot find module 'laravel-elixir'。Mac 上常因 Homebrew 或 nvm 装了新版 Node 导致失败。
- 运行
node -v，必须是v6.17.1或v7.10.1（Laravel Homestead 默认版本） - 用
npm install --global gulp-cli（不是gulp），旧版全局命令是gulp，但 5.2 需要 CLI v3.9.x - 别用
cnpm或镜像源装 Elixir 相关包，部分镜像缓存了损坏的laravel-elixir@6.0.0-13包，导致mix.sass()报 undefined
Gulpfile.js 必须放在项目根目录且 require 正确
Elixir 不会自动加载 node_modules/laravel-elixir，你得手动 require 它，且路径不能错。Mac 上大小写敏感 + Finder 隐藏文件容易导致 Gulpfile.js 实际叫 gulpfile.js（小写）而终端不报错但无反应。
- 确保文件名是
Gulpfile.js（首字母大写），不是gulpfile.js或Gulpfile - 内容开头必须有：
const elixir = require('laravel-elixir');（注意是单引号，双引号在某些 Mac shell 下会解析失败） - 不要写
var elixir = require('laravel-elixir');—— 5.2 的 Elixir 依赖 strict 模式，var会导致mix未定义 - 示例最小可用配置：
const elixir = require('laravel-elixir');<br>elixir(mix => {<br> mix.sass('app.scss');<br>});
npm install 后必须检查 node_modules/laravel-elixir 是否完整
Mac 上 npm install 常因权限、Xcode command line tools 缺失或 npm 缓存污染，导致 laravel-elixir 目录里缺 index.js 或 tasks/ 子目录，表现是运行 gulp 时提示 Cannot find module 'laravel-elixir' 却不报具体路径。
- 进
node_modules/laravel-elixir/目录，执行ls -la，确认存在index.js和tasks/文件夹 - 如果缺失，删掉整个
node_modules，再用npm install --no-bin-links（Mac + VM 场景必需） - 别用
npm ci—— 5.2 不支持 lockfile v2，会静默跳过 Elixir 安装 - 验证是否真装好：在项目根目录运行
node -e "console.log(require('laravel-elixir').version)"，应输出6.0.0-13
真正卡住的地方往往不是语法，而是 Mac 上 Node 版本和 Gulpfile.js 的大小写、权限、路径三者咬合不上；只要 node -v 对了、Gulpfile.js 在对的位置、require('laravel-elixir') 能执行出 version，剩下的就是 Sass 编译路径或输出目录权限问题了。
