Установка на macOS и Linux

На macOS и Linux Mojo ставится как обычный пакет — никакой виртуализации, как на Windows, не требуется. Весь путь занимает минут десять.

Перед началом

Убедитесь, что железо подходит: на macOS нужен Apple Silicon (маки на Intel не поддерживаются), на Linux — glibc 2.34+ и процессор уровня x86-64-v3. Подробности и команды проверки — в главе Системные требования.

Шаг 1. Подготовьте систему

Mojo компилирует программы в машинный код, и для финальной сборки ему нужен системный компилятор C — он выполняет линковку.

Linux

sudo apt update && sudo apt install -y build-essential curl

Для Fedora и RHEL:

sudo dnf install -y gcc curl

Для Arch:

sudo pacman -S --needed base-devel curl

macOS

Нужны Xcode Command Line Tools версии 16 или новее:

xcode-select --install

Если инструменты уже стоят, команда сообщит об этом. Проверить версию:

xcodebuild -version

Если версия ниже 16 — обновите Xcode через App Store либо переустановите Command Line Tools.

Шаг 2. Установите uv

uv — менеджер пакетов и проектов от Astral, который официальная документация Mojo предлагает как один из двух рекомендованных способов установки.

curl -LsSf https://astral.sh/uv/install.sh | sh

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

bash

source ~/.bashrc

zsh

source ~/.zshrc

fish

source ~/.config/fish/config.fish

Проверьте:

uv --version

Если uv уже установлен

Многие питонисты держат uv как замену pip и virtualenv — тогда этот шаг можно пропустить. Только обновитесь: uv self update.

Шаг 3. Создайте проект и поставьте Mojo

1. Создайте проект:

   uv init hello-mojo
   cd hello-mojo

2. Добавьте Mojo в зависимости:

   uv add mojo

   uv создаст виртуальное окружение .venv и скачает в него компилятор и стандартную библиотеку. Первый раз это занимает пару минут — пакет увесистый.

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

   uv run mojo --version

   Должна появиться версия 1.0.0 или новее в пределах ветки 1.x.

Получится такая структура:

• Directoryhello-mojo

  • Directory.venv/ окружение проекта, внутри компилятор Mojo

    • …
  • pyproject.toml зависимости проекта
  • uv.lock точные версии — этот файл коммитят в репозиторий
  • main.py создан uv по умолчанию, можно удалить

Почему Mojo ставится в проект, а не в систему

Это не причуда uv, а хорошая практика: у каждого проекта своя версия компилятора, зафиксированная в uv.lock. Обновление Mojo в одном проекте не ломает соседние, а коллега по репозиторию получит ровно ту же версию, что и вы. Обратная сторона — команда mojo не появляется в системе глобально, запускать нужно через uv run.

Шаг 4. Первая программа

hello.mojo

def main():
    print("Привет, Mojo!")

uv run mojo hello.mojo

Результат

Привет, Mojo!

Готово — окружение работает.

Как запускать без uv run

Постоянно печатать uv run необязательно. Активируйте окружение один раз за сессию терминала:

bash

source .venv/bin/activate
mojo hello.mojo

zsh

source .venv/bin/activate
mojo hello.mojo

fish

source .venv/bin/activate.fish
mojo hello.mojo

Выйти из окружения — командой deactivate.

В курсе везде используется вариант с uv run: он не зависит от того, активировано окружение или нет, и поэтому воспроизводим у всех читателей.

Типичные ошибки

error: externally-managed-environment

Что это значит

Вы пытаетесь поставить Mojo глобально через системный pip. Современные дистрибутивы Linux и Homebrew на macOS защищают системный Python от таких установок.

Как исправить

Так и должно быть — ставьте в проект: uv init и uv add mojo. Не обходите защиту флагом --break-system-packages: системный Python сломается тихо и не сразу.

mojo: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found

Что это значит

Дистрибутив слишком старый: в нём glibc ниже 2.34. Так бывает на Ubuntu 20.04, Debian 11 и CentOS 7.

Как исправить

Обновите дистрибутив до Ubuntu 22.04 LTS или новее — других вариантов, кроме контейнера с более свежей базой, здесь нет. Проверить текущую версию: ldd --version.

No solution found when resolving dependencies: mojo was not found in the package registry

Что это значит

Платформа не поддерживается: обычно это Mac на Intel или 32-битная система. Пакета под такую архитектуру просто нет.

Как исправить

Проверьте архитектуру: uname -m. Должно быть arm64 на macOS либо x86_64 / aarch64 на Linux. Если это Intel-мак — используйте удалённую машину или Codespaces.

ld: library not found / cc: command not found

Что это значит

Mojo скомпилировал программу, но не смог её слинковать: в системе нет компилятора C.

Как исправить

Вернитесь к шагу 1: на Linux поставьте build-essential (или gcc), на macOS — Command Line Tools через xcode-select --install.

🎯 Проверь себя

Зачем Mojo нужен системный компилятор C, если у него свой компилятор?

Свой компилятор превращает код Mojo в объектный файл, но собрать из объектных файлов исполняемую программу и подключить системные библиотеки должен линковщик — его берут из установленного cc, gcc или clang.

Чем `uv run mojo` отличается от активации окружения и вызова `mojo`?

Ничем по результату. uv run сам подставляет окружение проекта на время одной команды, активация делает то же самое на всю сессию терминала. В курсе используется uv run, потому что он работает одинаково независимо от состояния оболочки.

Нужно ли коммитить в репозиторий файл uv.lock?

Да. Он фиксирует точные версии Mojo и остальных зависимостей — благодаря ему у всех участников проекта собирается один и тот же код. А вот папку .venv коммитить не нужно, ей место в .gitignore.

Что дальше

Окружение готово — настроим редактор, чтобы работали автодополнение, подсказки и отладчик.