Как исправить ошибку ‘mvn: command not found’?

«Как исправить ошибку ‘mvn: command not found’?» — вопрос из категории DevOps, который задают на 10% собеседований Java Разработчик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

Ошибка возникает, когда Maven не установлен или его путь не добавлен в системную переменную PATH.

1. Проверка установки:

mvn -v

2. Установка Maven:

  • Скачайте бинарный дистрибутив с официального сайта Apache Maven.
  • Распакуйте архив в выбранную директорию (например, C:Toolsapache-maven-3.8.6 или /opt/apache-maven-3.8.6).

3. Настройка переменных окружения: Необходимо добавить путь к поддиректории bin из распакованного архива в PATH.

  • Linux/macOS: Добавьте в ~/.bashrc, ~/.zshrc или аналогичный файл:
    export MAVEN_HOME=/opt/apache-maven-3.8.6
    export PATH=$MAVEN_HOME/bin:$PATH

    Выполните source ~/.bashrc.

  • Windows:
    1. Создайте системную переменную MAVEN_HOME: C:Toolsapache-maven-3.8.6.
    2. Добавьте %MAVEN_HOME%bin в системную переменную Path.
    3. Важно: Перезапустите все окна терминала/командной строки.

4. Проверка в IDE:

  • IntelliJ IDEA: File → Settings → Build, Execution, Deployment → Build Tools → Maven. Укажите путь к Maven домашней директории (Maven Home Path).
  • Eclipse: Window → Preferences → Maven → Installations. Добавьте путь.

5. Альтернативная установка через пакетный менеджер:

# Ubuntu/Debian
sudo apt install maven

# macOS (Homebrew)
brew install maven

# Windows (Chocolatey)
choco install maven

После установки через менеджер PATH обычно настраивается автоматически.