Rails 6 & Webpacker 5自定义node_modules路径解决共享文件夹软链接失效问题

方案一：绑定挂载（最优，无侵入） #

VirtualBox共享文件夹仅不支持创建软链接，但支持Linux内核级的绑定挂载，直接将虚拟机本地的node_modules目录映射到项目根目录，所有工具无需修改配置即可正常识别：

• 第一步：在共享文件夹的项目根目录创建空node_modules目录

  mkdir -p /path/to/your/project/root/node_modules
  

• 第二步：执行绑定挂载

  sudo mount --bind /home/user/custom_path/node_modules /path/to/your/project/root/node_modules
  

• 第三步（可选，开机自动生效）：在/etc/fstab末尾添加挂载规则，避免每次重启虚拟机都要重新挂载

  /home/user/custom_path/node_modules /path/to/your/project/root/node_modules none bind 0 0
  

方案二：配置环境变量+Webpacker规则 #

如果不想使用挂载方案，可通过修改Node解析规则和Webpacker配置适配：

• 第一步：配置NODE_PATH全局环境变量，让Node进程优先从自定义路径查找依赖
  在虚拟机当前用户的shell配置文件（~/.bashrc/~/.zshrc）末尾添加：

  export NODE_PATH="/home/user/custom_path/node_modules:$NODE_PATH"
  

  执行source ~/.bashrc（对应zsh则是source ~/.zshrc）让配置立即生效。
• 第二步：修改Webpacker的webpack解析规则，在config/webpack/environment.js中添加模块路径配置：

  const { environment } = require('@rails/webpacker')
  // 新增下面这行，指定自定义node_modules路径
  environment.config.resolve.modules.append('/home/user/custom_path/node_modules')
  module.exports = environment
  

• 第三步：修改Webpacker执行脚本，让Rake任务能识别自定义路径
  在项目根目录的bin/webpack、bin/webpack-dev-server两个脚本的开头（Ruby代码区域）添加环境变量声明：

  ENV['NODE_PATH'] = "/home/user/custom_path/node_modules:#{ENV['NODE_PATH']}"
  

验证方法 #

配置完成后执行以下命令验证生效：

1. 执行node -e "console.log(require.resolve('@rails/webpacker'))"，正常会输出自定义路径下的@rails/webpacker安装路径
2. 执行rake webpacker:info，可正常显示@rails/webpacker的版本号，不再显示为空

补充说明 #

你之前配置的additional_paths未生效，是因为Webpacker 5的该配置仅作用于业务代码的模块解析，Webpacker自身的依赖加载、Rake任务的依赖检查逻辑不会读取该配置。

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