在Homestead中首次安装Laravel+Breeze时遇npm acorn符号链接错误

问题原因 #

Windows宿主机的共享目录挂载到Homestead虚拟机后，Linux系统在该目录下创建符号链接会触发EPROTO错误——这是Windows与Linux跨文件系统共享时的典型兼容性问题，两类系统的符号链接机制不兼容。

可行解决方案 #

方案1：让npm使用 junction 替代符号链接 #

在你的Laravel项目根目录（/home/vagrant/Code/flashcards）新建.npmrc文件，写入以下内容：

linker=junction

之后重新执行Breeze安装命令：

php artisan breeze:install

或者单独补装依赖：

npm install

方案2：在虚拟机非共享目录装依赖再复制 #

1. 在虚拟机里建个临时目录：

mkdir ~/temp-breeze
cd ~/temp-breeze

2. 复制项目的依赖配置文件过来并安装：

cp /home/vagrant/Code/flashcards/package.json .
cp /home/vagrant/Code/flashcards/package-lock.json . # 有这个文件就复制
npm install

3. 把装好的node_modules目录复制回项目：

cp -r node_modules /home/vagrant/Code/flashcards/

方案3：改用NFS挂载共享目录 #

编辑Homestead.yaml文件，给共享目录添加type: nfs配置：

folders:
    - map: ~/Code
      to: /home/vagrant/Code
      type: nfs

然后执行命令重新加载Homestead：

vagrant reload --provision

注意：Windows宿主机需要先开启NFS服务（控制面板→程序→启用或关闭Windows功能→勾选「服务 for NFS」），还要给Vagrant装插件：

vagrant plugin install vagrant-winnfsd

验证方法 #

依赖装好后，执行npm run dev测试前端资源编译，确认不再出现符号链接相关错误即可。

内容的提问来源于stack exchange，提问作者Ben