Установка языка Nim на macOS

В этом руководстве описаны два основных способа установки Nim на macOS:

• Через choosenim (рекомендуется): удобное управление версиями Nim, установка в домашний каталог пользователя.
• Через Homebrew: установка как brew-пакета (подходит тем, кто стандартизирует окружение через brew).

Также разберём настройку PATH, проверку компиляции и базовую работу с nimble.

Предварительные требования

1) Установите Xcode Command Line Tools

Nim использует системный компилятор C/C++ (обычно clang) для сборки итоговых бинарников.

xcode-select --install

Проверка:

clang --version
make --version

Если окно установки не появляется, инструменты могут быть уже установлены. Проверить путь:

xcode-select -p

Способ 1 (рекомендуется): установка Nim через choosenim

choosenim — официальный установщик/менеджер версий Nim.

1) Установите choosenim

curl https://nim-lang.org/choosenim/init.sh -sSf | sh

Скрипт:

• скачает choosenim,
• установит Nim (обычно stable),
• может предложить добавить строку в ваш shell-конфиг (например, ~/.zshrc) для PATH.

2) Перезапустите терминал или примените настройки

Если установщик добавлял изменения в ~/.zshrc, примените:

source ~/.zshrc

3) Проверьте версии Nim и Nimble

nim --version
nimble --version

4) Полезные команды choosenim

Показать текущую версию:

choosenim show

Обновить до актуальной stable:

choosenim update stable

Установить конкретную версию (пример):

choosenim 2.2.0

Способ 2: установка Nim через Homebrew

Этот вариант удобен, если вы предпочитаете управлять инструментами разработки через brew.

1) Установите Homebrew (если ещё не установлен)

Если Homebrew отсутствует, используйте наш гайд:

• /guides/macos/install-homebrew-on-macos

Быстрая проверка:

brew --version

2) Установите Nim

brew update
brew install nim

3) Проверьте установку

nim --version
nimble --version

Примечание: при установке через Homebrew обновление Nim выполняется через brew upgrade nim.

Настройка PATH (если nim не находится)

1) Диагностика

Проверьте, видит ли система nim:

which nim
echo $SHELL

Если which nim ничего не выводит, вероятно, путь к Nim не добавлен в PATH.

2) zsh (по умолчанию на macOS)

Откройте ~/.zshrc:

nano ~/.zshrc

Для установки через choosenim Nim часто находится в ~/.nimble/bin. Добавьте строку:

export PATH="$HOME/.nimble/bin:$PATH"

Примените:

source ~/.zshrc

Проверка:

which nim
nim --version

3) bash (если вы используете bash)

Откройте ~/.bash_profile или ~/.bashrc и добавьте:

export PATH="$HOME/.nimble/bin:$PATH"

Затем:

source ~/.bash_profile 2>/dev/null || source ~/.bashrc

Проверка: компиляция и запуск программы

Создайте файл hello.nim:

echo "Hello from Nim on macOS"

Соберите и запустите:

nim c -r hello.nim

Ожидаемый результат — вывод строки в терминал.

Установка пакетов через Nimble

nimble — пакетный менеджер Nim.

1) Поиск пакета

nimble search json

2) Установка пакета

Пример (пакет условный — используйте реальный из результатов поиска):

nimble install somepackage

3) Обновление установленных пакетов

nimble refresh
nimble update

Частые проблемы и решения

Ошибка: clang: error: invalid version number in 'MACOSX_DEPLOYMENT_TARGET=...'

Обычно связано с переменными окружения или несовместимыми настройками SDK.

Что сделать:

1. Проверьте значение переменной:

   echo $MACOSX_DEPLOYMENT_TARGET
   

2. Временно сбросьте и повторите сборку:

   unset MACOSX_DEPLOYMENT_TARGET
   nim c hello.nim
   

Ошибка: xcrun: error: invalid active developer path

Command Line Tools установлены некорректно или удалены после обновления macOS.

Решение:

sudo xcode-select --reset
xcode-select --install

Ошибка: Permission denied при установке пакетов

Если вы устанавливали Nim в системные каталоги или меняли права.

Рекомендуемый подход:

• используйте choosenim (установка в домашний каталог),
• не запускайте nimble install через sudo без крайней необходимости.

Что дальше

• Настройте редактор (например, VS Code) и установите расширение для Nim.
• Ознакомьтесь с документацией Nim и стандартной библиотекой.
• Для проектов используйте nimble init (создание структуры пакета/проекта).