Что такое Mix в Elixir и каковы его типичные задачи?

Mix — инструмент сборки и управления проектами в Elixir

Mix — это стандартный инструмент командной строки, поставляемый вместе с Elixir. Он выполняет роль одновременно системы сборки, пакетного менеджера и таск-раннера. Без Mix практически невозможно вести реальный Elixir-проект: он создаёт скаффолд, управляет зависимостями через Hex, компилирует код, запускает тесты и позволяет определять собственные задачи.

Типичные задачи Mix

• mix new — создание нового проекта (обычного или OTP-приложения с флагом --sup)
• mix deps.get / mix deps.compile — загрузка и компиляция зависимостей из mix.exs
• mix compile — инкрементальная компиляция исходного кода
• mix test — запуск тестов через ExUnit
• mix run — выполнение произвольного кода или скрипта
• mix release — сборка self-contained OTP-релиза для деплоя
• mix ecto.migrate — пример задачи из сторонней библиотеки (Ecto)
• mix format — автоформатирование кода по стандарту Elixir

Структура mix.exs

Каждый проект описывается файлом mix.exs, содержащим модуль с функциями project/0, application/0 и deps/0:

defmodule MyApp.MixProject do
  use Mix.Project

  def project do
    [
      app: :my_app,
      version: "0.1.0",
      elixir: "~> 1.17",
      start_permanent: Mix.env() == :prod,
      deps: deps()
    ]
  end

  def application do
    [
      extra_applications: [:logger],
      mod: {MyApp.Application, []}
    ]
  end

  defp deps do
    [
      {:phoenix, "~> 1.7"},
      {:ecto_sql, "~> 3.11"},
      {:postgrex, ">= 0.0.0"}
    ]
  end
end

Кастомные задачи

Собственная Mix-задача создаётся как модуль в пространстве имён Mix.Tasks с реализацией функции run/1:

defmodule Mix.Tasks.SendDigest do
  use Mix.Task

  @shortdoc "Отправляет еженедельный дайджест пользователям"

  @impl Mix.Task
  def run(_args) do
    Mix.Task.run("app.start")
    MyApp.Mailer.send_digest()
    Mix.shell().info("Digest sent.")
  end
end

Запуск: mix send_digest. Флаг Mix.Task.run("app.start") поднимает OTP-приложение, если задаче нужны запущенные процессы (БД, GenServer).

Environments

Mix поддерживает окружения :dev, :test, :prod. Текущее доступно через Mix.env/0. Зависимости можно ограничивать окружением:

{:ex_machina, "~> 2.7", only: [:test]}

Подводные камни

• Mix.env() недоступен в рантайме релиза — в mix release код компилируется, а Mix.env() возвращает nil; для рантайм-конфигурации нужен config/runtime.exs.
• Потеря инкрементальной компиляции — изменение заголовков макросов или модулей поведения инвалидирует зависимые файлы; при непонятных ошибках делают mix clean && mix compile.
• Конфликты версий hex-пакетов — Hex не умеет SemVer-ranges так же гибко, как npm; явная фиксация версий через mix.lock обязательна в CI.
• app.start в custom task — если задача работает с Repo/GenServer и не вызывает Mix.Task.run("app.start"), процессы не запущены и код упадёт с not started.
• Зависимость from umbrella vs обычный проект — в umbrella-монорепо каждое дочернее приложение имеет свой mix.exs; путать корневой и дочерний файл — частая ошибка новичков.
• only: :prod не попадает в dev-сборку — если нативный адаптер БД объявлен только для :prod, локальные тесты будут падать с «no adapter» без явного добавления :dev.

• Сводить mix к названию метода без lifecycle и failure path.
• Игнорировать модель runtime: Elixir компилируется в BEAM bytecode и наследует процессы, message passing, supervision и hot-code friendly модель Erlang VM.
• Не отделять validation, authorization, transaction boundary и business logic.

• Объясняет mix через конкретную точку lifecycle в Elixir.
• Приводит корректный минимальный пример без вымышленных методов или callbacks.
• Называет edge cases: пустые значения, ошибки, транзакции, безопасность или concurrency.