Rails 6应用复制独立化最佳方案：应对Webpacker相关影响

嘿，我在处理Rails 6应用复制时，也踩过Webpacker带来的这些坑——尤其是不可编辑的Makefile和到处都是应用名的package.json，给你整理一套实操性强的步骤：

一、基础复制与核心Rails配置修改 #

先完成最常规的复制和核心配置替换：

• 复制原应用目录到新名称的目录：

  cp -r original_app/ new_app/
  

• 进入新应用目录：

  cd new_app/
  

• 清除原应用的版本控制痕迹（如果需要独立仓库）：

  rm -rf .git/ && git init
  

• 修改核心Rails配置文件：
  • config/application.rb：把顶部的module OriginalApp替换为module NewApp，同时检查文件内所有引用原应用名的地方（比如config.application_name）
  • config/cable.yml：在各个环境的配置中，将频道标识里的原应用名替换为新应用名（比如channel_prefix: original_app_cable改成new_app_cable）
  • config/database.yml：修改每个环境下的数据库名称（比如database: original_app_development → database: new_app_development）
  • config/environments/production.rb：全局替换所有原应用名的引用，比如asset路径、应用名称配置等

二、处理Webpacker与package.json #

Webpacker的package.json是可编辑的，这部分我们可以彻底清理：

• 先删除原有的node_modules目录（避免旧依赖缓存干扰）：

  rm -rf node_modules/
  

• 编辑package.json：
  • 修改最顶部的name字段为新应用名
  • 检查scripts区块，把所有包含原应用名的命令替换（比如webpack-dev-server的--app参数）
  • 确认dependencies和devDependencies中没有绑定原应用名的包（这类情况很少见，但如果有也要同步修改）
• 重新安装前端依赖：

  yarn install # 或者 npm install，根据你项目的包管理器
  

  这一步会生成适配新应用名的node_modules，确保Webpacker能正常工作

三、解决不可编辑的Makefile问题 #

既然Makefile不能修改，我们可以用临时变量覆盖或者动态替换的方式绕过：

方案1：执行Make命令时临时传参 #

如果Makefile是用变量（比如APP_NAME）定义应用名的，直接在执行时覆盖变量即可：

APP_NAME=new_app make [your-target]

比如要执行make build，就改成APP_NAME=new_app make build，这样Makefile会自动使用新的应用名。

方案2：创建辅助脚本简化操作 #

如果不想每次都输入变量，可以在新应用目录下创建一个run_make.sh脚本：

#!/bin/bash
# 替换成你的新应用名
export APP_NAME=new_app
# 传递所有命令行参数给make
make "$@"

然后给脚本加执行权限：

chmod +x run_make.sh

之后执行Make命令就用：

./run_make.sh [your-target]

方案3：针对硬编码应用名的Makefile #

如果Makefile里直接写死了原应用名（没有用变量），可以用sed临时替换后执行：

# 临时替换原应用名为新应用名，生成临时Makefile并执行
sed 's/original_app/new_app/g' Makefile > temp_makefile && make -f temp_makefile [your-target] && rm temp_makefile

这一步会临时生成修改后的Makefile，执行完自动删除，完全不会改动原文件。

四、收尾验证与部署调整 #

• 创建新应用的数据库：

  rails db:create
  

• 执行数据库迁移：

  rails db:migrate
  

• 启动服务测试：
  同时启动Rails服务器和Webpack dev server：

  rails s
  # 新开一个终端窗口执行
  bin/webpack-dev-server
  

  访问应用确认功能正常，前端资源加载没有问题。
• 调整部署配置：如果用Capistrano之类的部署工具，要把config/deploy.rb、服务器部署路径等所有原应用名的引用替换为新应用名。

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