新机器用Vagrant重装Homestead/Laravel遇文件夹挂载失败求助

我之前在Windows 10环境下部署Homestead时，也碰到过和你完全一样的挂载错误。结合你给出的配置信息（Vagrant 2.0.3、VirtualBox 5.2.8、未修改的Homestead.yaml），给你几个针对性的排查和解决步骤：

1. 修正Homestead.yaml的路径格式 #

Windows系统下，Vagrant对路径的解析容易出问题，即使你没修改默认配置，也建议检查并调整：

• 默认的folders映射可能用了~/code，Windows下~指向用户目录，但有时候会解析失败，替换为绝对路径，比如：

  folders:
      - map: C:/Users/你的用户名/code
        to: /home/vagrant/code
  

  注意用正斜杠/，或者转义的反斜杠\\，不要用单个反斜杠（会被当成转义字符）。

2. 同步VirtualBox Guest Additions版本 #

VirtualBox的共享文件夹依赖Guest Additions，主机和虚拟机内的版本必须匹配：

• 安装vagrant-vbguest插件，它会自动帮你同步版本：

  vagrant plugin install vagrant-vbguest
  

• 执行完后，销毁现有虚拟机并重新创建：

  vagrant destroy -f
  vagrant up
  

3. 检查文件夹权限与系统拦截 #

Windows的权限和安全软件经常会阻止Vagrant创建共享：

• 右键你要映射的文件夹（默认是用户目录下的code），选择属性 -> 安全，确保当前用户拥有读写/完全控制权限。
• 临时关闭Windows Defender实时保护、第三方杀毒软件，再尝试vagrant up，排除安全软件拦截的可能。

4. 验证VirtualBox共享文件夹配置 #

有时候虚拟机的共享文件夹条目会丢失或配置错误：

• 打开VirtualBox，找到Homestead虚拟机，进入设置 -> 共享文件夹，确认存在一条映射到你本地code文件夹、目标为/home/vagrant/code的条目。
• 如果没有，先vagrant destroy删除虚拟机，再重新vagrant up让Vagrant自动创建共享配置。

5. 手动挂载排查具体错误 #

如果以上步骤都无效，手动挂载可以帮你定位具体问题：

1. 启动虚拟机但跳过配置：

   vagrant up --no-provision
   

2. 进入虚拟机：

   vagrant ssh
   

3. 尝试手动挂载（替换你的本地路径为实际路径）：

   sudo mount -t vboxsf code /home/vagrant/code
   

   执行后会给出具体的错误提示，比如路径不存在、权限不足等，根据提示再针对性解决。

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