Установка Nim на Windows

Это руководство показывает несколько способов установки Nim на Windows: официальный (choosenim) и альтернативные (Scoop/Chocolatey), а также настройку окружения, проверку установки и типовые решения проблем.

Требования

• Права пользователя (для установки через менеджеры пакетов могут понадобиться админ-права).
• Доступ в интернет.
• Терминал: Windows Terminal / PowerShell (рекомендуется) или cmd.

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

1) Установка choosenim

Откройте PowerShell и выполните:

# Скачивание и запуск установщика choosenim
iwr https://nim-lang.org/choosenim/init.ps1 -useb | iex

Если политика выполнения PowerShell запрещает запуск скриптов, временно разрешите для текущего процесса:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
iwr https://nim-lang.org/choosenim/init.ps1 -useb | iex

Примечание: после установки закройте и откройте терминал заново, чтобы обновился PATH.

2) Установка/обновление Nim

Установить стабильную версию:

choosenim stable

Проверить доступные версии:

choosenim show

Обновить choosenim и Nim:

choosenim update self
choosenim update stable

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

nim -v
nimble -v
where.exe nim
where.exe nimble

Ожидаемо вы увидите версию Nim, версию Nimble и пути к исполняемым файлам.

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

1) Установка Scoop (если не установлен)

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
iwr -useb get.scoop.sh | iex

2) Установка Nim

scoop install nim

Проверка:

nim -v
nimble -v

Способ 3: установка через Chocolatey

Требуются права администратора и установленный Chocolatey.

Установка:

choco install nim -y

Проверка:

nim -v
nimble -v

Способ 4: ручная установка (если менеджеры недоступны)

1. Скачайте релиз Nim для Windows с официальных источников (релизы Nim).
2. Распакуйте архив, например в:
   • C:\Tools\Nim\
3. Добавьте в PATH папки, где лежат nim.exe и nimble.exe (см. раздел ниже).
4. Перезапустите терминал и проверьте:

   nim -v
   nimble -v
   

Зависимости: C-компилятор для сборки проектов Nim

Nim компилирует код в C/C++, поэтому для сборки большинства проектов нужен toolchain.

Вариант A (рекомендуется): MSVC (Visual Studio Build Tools)

1. Установите Build Tools for Visual Studio (C++ build tools).
2. Убедитесь, что установлены компоненты:
   • MSVC v14x
   • Windows SDK

Проверка в Developer PowerShell for VS:

cl

Если cl доступен — MSVC установлен.

Вариант B: MinGW-w64

Если вы используете MinGW (часто удобно в сочетании со Scoop):

scoop install mingw
gcc --version

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

Быстрая диагностика

where.exe nim
where.exe nimble

Если ничего не найдено — PATH не содержит путь к Nim.

Где обычно расположен Nim

Зависит от способа установки:

• choosenim: часто в профиле пользователя, например:
  • %USERPROFILE%\.nimble\bin (для nimble-утилит)
  • каталоги Nim внутри %USERPROFILE%\.choosenim\... (может отличаться)
• Scoop:
  • %USERPROFILE%\scoop\apps\nim\current\bin
• Chocolatey:
  • C:\ProgramData\chocolatey\bin (часто как shim) + папки пакета

Уточнить фактические пути можно так:

# Покажет, где лежит nim.exe (если уже находится)
where.exe nim

# Путь к nimble-пакетам/бинари
nimble path

Добавление в PATH через интерфейс Windows

1. Win + R → sysdm.cpl → вкладка Дополнительно → Переменные среды.
2. В Переменные пользователя выберите Path → Изменить.
3. Добавьте путь к папке с nim.exe и (при необходимости) %USERPROFILE%\.nimble\bin.
4. Нажмите OK и перезапустите терминал.

Быстрый тест: компиляция и запуск программы

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

echo "Hello from Nim on Windows!"

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

nim c -r hello.nim

Если всё настроено, вы увидите вывод строки в терминале.

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

Обновить список пакетов:

nimble refresh

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

nimble install winim

Проверить, что бинарники Nimble попадают в PATH:

# Папка, где Nimble хранит установленные бинарники
nimble path

Обычно нужно добавить в PATH: %USERPROFILE%\.nimble\bin.

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

1) nim/nimble не распознаётся как команда

Причины: PATH не обновился, терминал не перезапущен, установка не завершилась.

Решение:

• Перезапустите терминал.
• Проверьте where.exe nim.
• Добавьте корректные пути в PATH.

2) Ошибки компиляции/линковки (нет C-компилятора)

Симптомы: сообщения про cl.exe/gcc/linker, ошибки на этапе CC:.

Решение:

• Установите MSVC Build Tools (рекомендуется) или MinGW-w64.
• Запускайте сборку из окружения, где доступен компилятор (например, Developer PowerShell для MSVC).

3) Ошибка загрузки/установки из-за сети (в т.ч. прокси/антивирус)

Решение:

• Проверьте доступ к доменам Nim/репозиториев.
• В корпоративной сети настройте прокси для PowerShell и Git (если используется).
• Повторите установку после временного отключения фильтрации (если разрешено политиками).

4) Связанная системная ошибка Windows 0x8007045D

Код 0x8007045D обычно связан с ошибками ввода-вывода (I/O) при чтении/записи. Если установка Nim/загрузка архивов прерывается:

• Попробуйте другой диск/папку (например, не в сетевой папке).
• Проверьте свободное место.
• Запустите проверку диска:

  chkdsk C: /scan
  

• Скачайте установщик/архив заново (возможна порча файла).

Рекомендации по IDE и подсказкам

Для автодополнения и анализа кода часто используют nimsuggest (обычно устанавливается вместе с Nim).

Популярные редакторы:

• VS Code (расширения для Nim)
• Neovim/Vim/Emacs (через LSP/плагины)

Проверьте:

nimsuggest --version

Что дальше

• Настройте рабочий проект и .nimble-файл (если используете Nimble).
• Зафиксируйте версию Nim для команды/CI (choosenim упрощает управление версиями).
• Добавьте %USERPROFILE%\.nimble\bin в PATH, если ставите CLI-утилиты через Nimble.