You need to enable JavaScript to run this app. Rails6 Webpacker安装jQuery时application.js不生效
优惠活动
大模型
产品
解决方案
定价
更多

Rails6 Webpacker安装jQuery时application.js不生效

Rails 6 项目jQuery安装失效、文件改动不同步问题

故障现象

  • 项目基于Rails 6框架,通过yarn安装jQuery后,所有jQuery绑定的交互功能始终无法触发
  • 打开Chrome开发者工具的资源加载面板核对,发现本地修改的application.js内容,没有同步到浏览器实际加载的线上文件中

Chrome开发者工具检查面板截图

现有项目配置

application.html.erb

<%= javascript_pack_tag 'application', 'data-turbolinks-track': 'reload' %

application.js

require("@rails/ujs").start()
require("turbolinks").start()
require("@rails/activestorage").start()
require("channels")
require("jquery")
import "boostrap"

environment.js

const { environment } = require('@rails/webpacker')

const webpack = require('webpack')
    environment.plugins.prepend('Provide',
        new webpack.ProvidePlugin({
        $: 'jquery/src/jquery',
        jQuery: 'jquery/src/jquery'
    })
)

module.exports = environment

其他环境说明

  • Gemfile中指定webpacker版本为gem 'webpacker', '~> 4.0'
  • jQuery依赖通过执行yarn add jquery安装
  • 已尝试的操作:删除public目录、执行bundle exec rake assets:clean,问题未解决

核心故障原因与修复步骤

  1. 清理操作范围匹配错误
    Webpacker 4的编译产物、缓存路径与旧版Asset Pipeline的路径完全独立。之前执行的bundle exec rake assets:clean仅会清理public/assets目录下的旧管线文件,不会触及webpack的编译缓存、以及public/packs目录下的打包产物,根本无法触发文件更新。
    正确的清理执行命令:

    rm -rf node_modules/.cache
    rm -rf public/packs
    
  2. 配置文件存在语法、拼写错误,导致webpack编译中断

    • 原application.html.erb中的javascript_pack_tag代码缺少结尾的闭合>,会导致ERB模板渲染报错,无法正确注入打包后的JS资源,需要补全标签闭合
    • 原application.js中导入bootstrap时拼写错误,写为import "boostrap",错误的导入路径会直接导致webpack编译失败,浏览器会持续加载上一次编译成功的旧版本文件,自然看不到新写的require("jquery")相关改动
    • 原environment.js中ProvidePlugin的jQuery路径配置错误,手动指定jquery/src/jquery的路径在webpacker4匹配的jQuery版本中无法正确解析,即使文件加载成功,全局$、jQuery变量也不会被注入,jQuery功能会完全失效
      修正后的environment.js参考配置:
    const { environment } = require('@rails/webpacker')
    const webpack = require('webpack')
    
    environment.plugins.prepend('Provide', new webpack.ProvidePlugin({
      $: 'jquery',
      jQuery: 'jquery'
    }))
    
    module.exports = environment
    
  3. 未重启webpack监听进程
    所有webpack相关的配置、入口文件修改完成后,必须重启webpack的watch进程,才会触发全量重新编译。直接执行命令启动编译服务即可:

    ./bin/webpack-dev-server
    

    编译完成后刷新页面,在开发者工具的网络面板中检查加载的JS文件,确认新写入的require("jquery")、全局$变量注入的代码已经存在,即可正常使用jQuery功能。


内容的提问来源于stack exchange,提问作者Gaston

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 11:06:07