
Версия Ruby, поставляемая по умолчанию в Mac OS, часто устаревает. Это приводит к несовместимости с современными гемами и фреймворками. Последнее стабильное обновление Ruby на 2025 год – версия 3.2.2. Поддержка предыдущих версий ограничена, поэтому обновление – необходимость для разработки.
Mac OS использует систему управления пакетами Homebrew, которая упрощает установку и обновление Ruby. Рекомендуется проверять установленную версию через команду ruby -v. Для полноценного обновления понадобится установить или обновить Homebrew до последней версии (brew update).
Перед обновлением важно создать резервную копию текущей среды разработки и проектов. Это исключает риск потери данных и проблем с зависимостями. Для управления версиями Ruby стоит использовать rbenv или chruby, что позволяет переключаться между версиями без конфликтов.
В этом руководстве будут представлены конкретные команды и порядок действий для обновления Ruby на Mac OS с минимальными рисками и без лишних шагов. Следуя инструкции, процесс займет не более 10–15 минут и обеспечит стабильную работу среды разработки.
Обновление Ruby на Mac OS: пошаговое руководство

1. Проверка текущей версии Ruby. Откройте терминал и выполните команду: ruby -v. Запишите результат для сравнения после обновления.
2. Установка Homebrew (если не установлен). Выполните: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". Проверьте установку: brew --version.
3. Установка или обновление rbenv. Выполните: brew install rbenv или brew upgrade rbenv. Добавьте в профиль команду: eval "$(rbenv init -)". Перезапустите терминал.
4. Просмотр доступных версий Ruby. Выполните: rbenv install -l. Найдите нужную версию, например 3.2.2.
5. Установка новой версии Ruby. Запустите: rbenv install 3.2.2. Ожидайте завершения процесса (занимает несколько минут).
6. Настройка версии по умолчанию. Выполните: rbenv global 3.2.2. Проверьте: ruby -v должно показать обновлённую версию.
7. Обновление RubyGems и Bundler. Выполните: gem update --system и gem install bundler. Проверьте версии: gem -v и bundler -v.
8. Очистка устаревших версий. Выполните: rbenv uninstall [старые_версии] для освобождения места.
Рекомендация: всегда проверяйте совместимость ваших проектов с новой версией Ruby перед обновлением, используя rbenv local [версия] для тестирования.
Проверка текущей версии Ruby на Mac
Для точной проверки версии Ruby используйте встроенные инструменты терминала. Это необходимо для понимания, требуется ли обновление.
- Откройте Терминал (Terminal).
- Введите команду:
ruby -v
- Система вернёт строку формата:
ruby 3.1.2p20 (2023-04-05 revision 0) [arm64-darwin21]
Здесь:
- 3.1.2 – версия Ruby;
- p20 – патч-релиз;
- arm64-darwin21 – архитектура и версия macOS.
Для проверки версии менеджера Ruby (rbenv или rvm), используйте:
- Для rbenv:
rbenv version
- Для RVM:
rvm list
Результат укажет, какая версия активна и используется по умолчанию. Это критично при работе с проектами, где версия Ruby жёстко задана.
После проверки зафиксируйте версию в документации проекта или в файле .ruby-version, чтобы исключить несовместимости при последующих обновлениях.
Установка Homebrew для управления пакетами
Homebrew – основной менеджер пакетов для macOS, необходимый для установки и обновления Ruby. Проверить наличие Homebrew можно командой brew —version. Если установлен, отобразится версия; если нет – система вернёт ошибку.
Для установки выполните команду в терминале:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
После установки выполните brew doctor для проверки корректности конфигурации. Рекомендуется добавить Homebrew в системный PATH. Для zsh используйте:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Для bash аналогичная команда:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile
Проверить работу можно командой brew help. Homebrew автоматически управляет зависимостями и обеспечивает стабильное обновление Ruby и сопутствующих библиотек.
Установка менеджера версий Ruby (rbenv или RVM)
Для управления версиями Ruby на macOS рекомендуются два инструмента: rbenv и RVM. Выбор зависит от предпочтений и требований проекта. rbenv обеспечивает минимальное вмешательство в систему, RVM включает более широкий функционал, включая управление гемсетами.
Установка rbenv:
1. Убедитесь, что установлен Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)".
2. Установите rbenv и ruby-build: brew install rbenv ruby-build.
3. Добавьте в профиль оболочки (~/.zshrc или ~/.bash_profile): eval "$(rbenv init -)".
4. Перезапустите терминал и проверьте: rbenv -v. Должна отобразиться версия rbenv.
Установка RVM:
1. Установите GPG ключи: gpg --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 и gpg --recv-keys 7D2BAF1CF37B13E2069D6956105BD0E739499BDB.
2. Запустите установку: \curl -sSL https://get.rvm.io | bash -s stable.
3. Добавьте загрузку RVM в профиль оболочки: source ~/.rvm/scripts/rvm.
4. Проверьте установку: rvm -v.
После установки rbenv или RVM можно переходить к загрузке нужной версии Ruby и настройке окружения для проектов.
Поиск доступных версий Ruby
Для поиска доступных версий Ruby на Mac OS используйте менеджеры версий, такие как rbenv или rvm. Они позволяют просматривать полный список релизов и выбирать подходящий.
С помощью rbenv выполните команду:
rbenv install -l. Это покажет все версии Ruby, включая стабильные, предварительные и устаревшие релизы.
Для rvm используйте:
rvm list known. Вы получите список доступных версий с указанием текущих стабильных и рекомендуемых.
Дополнительно можно проверить официальный репозиторий Ruby:
https://www.ruby-lang.org/en/downloads/releases/,
где представлены номера версий, даты релизов и заметки к обновлениям.
Рекомендуется ориентироваться на последние стабильные версии или версии, поддерживающие необходимые гемы и библиотеки. Для проектов с критическими требованиями выбирайте версии с LTS или поддержкой безопасности.
При выборе версии учитывайте совместимость с используемыми фреймворками и системными библиотеками, чтобы избежать конфликтов после обновления.
Скачивание и установка новой версии Ruby
Для обновления Ruby на macOS рекомендуется использовать менеджер версий rbenv или asdf. Эти инструменты упрощают установку и управление несколькими версиями Ruby.
Убедитесь, что Xcode Command Line Tools установлены: выполните xcode-select --install в терминале. Это обеспечит доступ к необходимым компиляторам и библиотекам.
Для установки rbenv выполните:
brew install rbenv
После установки добавьте инициализацию rbenv в конфигурацию оболочки, например для zsh: echo 'eval "$(rbenv init -)"' >> ~/.zshrc, затем выполните source ~/.zshrc.
Проверьте доступные версии Ruby: rbenv install -l. Выберите нужную версию, например 3.2.2, и выполните установку:
rbenv install 3.2.2
После завершения установки установите выбранную версию по умолчанию: rbenv global 3.2.2. Проверьте результат: ruby -v должен отобразить новую версию.
Альтернативно можно использовать asdf: установите через Homebrew (brew install asdf), добавьте инициализацию в конфигурацию оболочки и используйте asdf plugin add ruby, затем asdf install ruby 3.2.2.
После установки рекомендуется проверить работу gem: gem update --system и gem list для актуальности установленных библиотек.
Переключение на обновлённую версию Ruby

После установки новой версии Ruby необходимо переключиться на неё, чтобы система использовала обновлённый интерпретатор. Для управления версиями рекомендуется использовать rbenv или RVM.
Использование rbenv

- Проверьте установленные версии Ruby командой:
rbenv versions - Установите версию по умолчанию для всей системы:
rbenv global 3.2.2Замените
3.2.2на вашу обновлённую версию. - Обновите настройки:
rbenv rehash - Проверьте активную версию:
ruby -v
Использование RVM

- Список установленных версий:
rvm list - Переключитесь на нужную версию:
rvm use 3.2.2 --default - Проверьте результат:
ruby -v
Проверка и устранение ошибок
- Если версия не меняется, убедитесь, что путь к Ruby в
$PATHсоответствует используемому менеджеру версий. - Для rbenv выполните:
echo $PATH | grep rbenv - Для RVM проверьте загрузку скрипта в
~/.bash_profileили~/.zshrc:[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
После переключения рекомендуется перезапустить терминал и проверить работу Ruby, чтобы убедиться, что используется корректная версия.
Проверка работоспособности новой версии
После обновления Ruby на Mac OS важно убедиться, что новая версия установлена корректно и функционирует без ошибок. Для этого выполните следующие шаги.
1. Проверьте версию Ruby командой:
ruby -v
2. Убедитесь, что используется правильный менеджер версий (rbenv или RVM). Для rbenv выполните:
rbenv version
3. Проверьте работоспособность Ruby с помощью запуска тестового скрипта:
echo 'puts "Ruby работает"' > test.rb
ruby test.rb
Ожидаемый результат: Ruby работает.
| Проверка | Команда | Ожидаемый результат |
|---|---|---|
| Версия Ruby | ruby -v |
ruby 3.x.xpxxx |
| Версия rbenv/RVM | rbenv version или rvm list |
Указанная новая версия |
| Тестовый скрипт | ruby test.rb |
Ruby работает |
4. Проверьте совместимость гемов: выполните bundle install в вашем проекте и убедитесь, что нет ошибок установки.
5. При обнаружении ошибок пересоберите гемы командой:
gem pristine --all
Регулярная проверка после обновления поможет избежать проблем в работе проектов и обеспечит стабильную среду разработки.
Решение возможных ошибок при обновлении
Ошибка: «Permission denied» при установке Ruby через rbenv
Решение: выполните команду sudo chown -R $(whoami) ~/.rbenv для смены владельца директории rbenv. После этого выполните rbenv rehash.
Ошибка: «ruby-build: definition not found»
Решение: обновите плагин ruby-build командой brew upgrade ruby-build или brew reinstall ruby-build. После этого повторите установку Ruby.
Ошибка: несовпадение версий после установки
Решение: проверьте текущую версию командой ruby -v. Если версия не совпадает, выполните rbenv global <версия> и rbenv rehash.
Ошибка: отсутствие библиотек при сборке Ruby
Решение: установите необходимые зависимости через Homebrew: brew install openssl libyaml libffi. Затем повторите установку Ruby, указав путь к библиотекам: RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl)" rbenv install <версия>.
Ошибка: сбой при обновлении Bundler
Решение: удалите старую версию командой gem uninstall bundler, затем установите последнюю: gem install bundler. Проверьте версию: bundler -v.
Ошибка: «rbenv: command not found»
Решение: добавьте инициализацию rbenv в конфигурационный файл оболочки (~/.zshrc или ~/.bash_profile): eval "$(rbenv init -)", затем выполните source ~/.zshrc.
Ошибка: конфликт с системной версией Ruby
Решение: используйте rbenv local <версия> для установки версии Ruby в конкретной директории проекта. Это исключит влияние системной версии.
Вопрос-ответ:
Как проверить текущую версию Ruby на Mac OS перед обновлением?
Откройте Терминал и введите команду ruby -v. Она покажет установленную версию Ruby. Это позволит убедиться, что обновление действительно необходимо, и понять, какая версия у вас сейчас установлена. Кроме того, полезно проверить, используется ли системная версия Ruby или версия, установленная через менеджер пакетов.
Можно ли обновить Ruby на Mac OS без установки дополнительных инструментов?
Технически можно использовать встроенную версию Ruby, но она может быть устаревшей и ограниченной по функционалу. Для обновления обычно используют менеджеры версий, такие как rbenv или rvm, поскольку они позволяют легко устанавливать разные версии Ruby и переключаться между ними. Без таких инструментов процесс обновления будет более сложным и рискованным.
Что делать, если после обновления Ruby на Mac OS некоторые гемы перестали работать?
После обновления Ruby иногда необходимо переустановить гемы, так как они могут быть скомпилированы для другой версии интерпретатора. Проверьте список установленных гемов с помощью команды gem list, затем переустановите их через gem install. Также стоит убедиться, что используется правильная версия Ruby с помощью менеджера версий.
Какие риски могут возникнуть при обновлении Ruby на Mac OS и как их избежать?
Основные риски связаны с несовместимостью приложений и гемов после обновления. Чтобы снизить их, стоит сначала создать резервную копию текущей системы или использовать менеджер версий, который позволяет легко возвращаться к предыдущей версии Ruby. Также рекомендуется тестировать обновлённую версию в отдельной среде перед применением её в рабочих проектах.
Можно ли установить несколько версий Ruby на Mac OS и переключаться между ними?
Да, для этого удобно использовать менеджеры версий, например rbenv или rvm. Они позволяют устанавливать несколько версий Ruby и переключаться между ними с помощью простых команд. Это полезно при работе с проектами, которые требуют разные версии интерпретатора, и помогает избежать конфликтов между приложениями.
Как проверить текущую версию Ruby на Mac перед обновлением?
Чтобы узнать версию Ruby на Mac, откройте терминал и введите команду ruby -v. Она покажет номер установленной версии и сборку. Если установлен менеджер версий, например rbenv или RVM, убедитесь, что вы проверяете именно ту версию, которая используется в вашей рабочей среде, так как системная версия Ruby может отличаться от версии проекта.
С какими сложностями можно столкнуться при обновлении Ruby на Mac, и как их избежать?
При обновлении Ruby на Mac часто возникают проблемы, связанные с несовместимостью версий библиотек или зависимостей. Например, после обновления могут перестать работать некоторые гемы, если они не поддерживают новую версию Ruby. Чтобы снизить риск ошибок, рекомендуется: сделать резервную копию текущей среды, использовать менеджеры версий Ruby, такие как rbenv или RVM, и проверить совместимость гемов с целевой версией. Также полезно использовать bundle update в проекте после обновления Ruby, чтобы обновить зависимости.
