常見問題疑難排解

使用 Bundler 卡住了嗎？在提交新問題之前，請瀏覽這些常見問題。

安裝 bundler 時權限遭拒

某些作業系統，例如 macOS 和 Ubuntu，其 Ruby 版本需要提升權限才能安裝寶石。

ERROR:  While executing gem ... (Gem::FilePermissionError)
  You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

有多種方法可以解決此問題。您可以使用 sudo 或 su 以提升權限來安裝 bundler。

sudo gem install bundler

如果您無法提升權限或不想在全球安裝 Bundler，則可以使用 --user-install 選項。

gem install bundler --user-install

這將把 Bundler 安裝到您的主目錄中。請注意，您需要將 ~/.gem/ruby/<ruby version>/bin 附加到您的 $PATH 變數才能使用 bundle。

Heroku 錯誤

如果您在部署時遇到問題，請向 Heroku 開立問題單。他們有一個專業的支援團隊，可以比 Bundler 團隊更好地協助您解決 Heroku 問題。如果您遇到的問題是 Bundler 本身的錯誤，Heroku 支援可以將確切的詳細資訊提供給我們。

其他問題

首先，找出您要執行的確切操作（請參閱 XY 問題）。然後，前往 Bundler 文件網站，看看我們是否有相關操作說明。

其次，查看相容性清單，並確保您使用的 Bundler 版本與您使用的 Ruby 和 RubyGems 版本相容。要查看您的版本

# Bundler version
bundle -v

# Ruby version
ruby -v

# RubyGems version
gem -v

如果這些說明無法解決問題，或者您找不到任何適當的說明，您可以嘗試這些疑難排解步驟

# Update to the latest version of bundler
gem install bundler

# Remove user-specific gems and git repos
rm -rf ~/.bundle/ ~/.gem/bundler/ ~/.gems/cache/bundler/

# Remove system-wide git repos and git checkouts
rm -rf $GEM_HOME/bundler/ $GEM_HOME/cache/bundler/

# Remove project-specific settings
rm -rf .bundle/

# Remove project-specific cached gems and repos
rm -rf vendor/cache/

# Remove the saved resolve of the Gemfile
rm -rf Gemfile.lock

# Uninstall the rubygems-bundler and open_gem gems
rvm gemset use global # if using rvm
gem uninstall rubygems-bundler open_gem

# Try to install one more time
bundle install

常見問題疑難排解

安裝 bundler 時權限遭拒

Heroku 錯誤

其他問題

指南