Rails 5使用bcrypt gem报错：cannot load such file -- bcrypt 求助

Hey there, let's work through this bcrypt issue step by step—this is super common for Rails beginners, so don't stress!

First, let's start with the basics because that's usually where the problem lies:

1. 确认Gemfile配置与bundle安装 #

• 打开你的Gemfile，确保里面有gem 'bcrypt'这一行，不要把它放在group :development或者group :test这类限定环境的块里（除非你故意只在特定环境用，但has_secure_password在开发环境也需要），也不要用#注释掉它。
• 保存Gemfile后，在终端里运行bundle install。跑完之后可以用bundle list bcrypt检查一下，如果能看到bcrypt的版本信息，说明安装成功；如果提示找不到，那就手动先装：gem install bcrypt，再重新跑bundle install。

2. 重启Spring服务器（关键！很多人忽略这个） #

Rails的Spring预加载器会缓存你的gem环境，有时候即使你装了新gem，它也没更新。解决方法很简单：

• 在终端运行spring stop，关闭后台的Spring进程
• 然后重新启动Rails服务器：rails s
  这时候再试试访问视图，应该能加载bcrypt了。

3. 检查版本兼容性 #

如果上面两步没用，可能是bcrypt版本和你的Rails/Ruby版本不匹配：

• 比如如果你用的是Rails 5.x或者更早的版本，试试指定兼容的bcrypt版本：把Gemfile里的行改成gem 'bcrypt', '~> 3.1.13'，然后bundle install。新版本的bcrypt可能只支持Ruby 2.5+或者Rails 6+，老项目需要降版本。

4. 修复bcrypt的native扩展编译问题 #

有时候bcrypt装不上是因为本地缺少编译依赖，导致native扩展没生成：

• 先卸载现有bcrypt：gem uninstall bcrypt（如果有多个版本，选全部卸载）
• 安装依赖：
  • Mac用户：运行xcode-select --install安装Xcode命令行工具
  • Ubuntu/Debian用户：运行sudo apt-get install ruby-dev build-essential
• 然后重新安装bcrypt：gem install bcrypt，再bundle install

5. 确认Model与数据库配置正确 #

最后，别忘了has_secure_password的前提：

• 你的Model（比如User）里必须有has_secure_password这一行
• 对应的数据库表必须有password_digest字段（不是password）！如果没有，生成迁移：rails generate migration AddPasswordDigestToUsers password_digest:string，然后跑rails db:migrate

按照这些步骤走下来，应该能解决加载失败的问题。如果还是不行，可以把终端里的完整报错信息贴出来，能更精准定位~

内容的提问来源于stack exchange，提问作者Abdul Mukheem Shaik