Что такое…

Что такое флаг в команде — и почему git commit -ma ломается, а -am нет

Иллюстрация: на пульте рядом с большой кнопкой ряд маленьких тумблеров, робот переключает один из них

Вот две команды, которые выглядят одинаково:

git commit -am "fix login"
git commit -ma "fix login"

Первая делает коммит. Вторая падает с ошибкой pathspec 'fix login' did not match any file(s). Мы проверили. Переставили две буквы — и git внезапно ищет файл с именем «fix login». Причина в том, как устроены флаги. Через пять минут ты будешь читать любые -xzvf без гугла.

Что такое флаг простыми словами

Флаг (ещё говорят «опция», «ключ») — это настройка команды. Сама команда говорит, что делать, а флаги — как.

ls          # покажи файлы
ls -l       # покажи файлы списком, с размерами и датами
ls -a       # покажи и скрытые тоже

Флаги бывают двух видов:

  • Переключатель — просто включает поведение. -a, --force, --draft. Значения у него нет.
  • Флаг со значением — ждёт, что сразу за ним идёт его значение. -m "текст", --title "Fix login", -n 5.

И два способа записи. Короткий: один дефис и одна буква, -f. Длинный: два дефиса и слово, --force. Часто это одно и то же, просто длинный легче читать. Где команда стоит в общей схеме «программа → подкоманда → флаги → аргументы», мы разбирали в статье что такое CLI.

Склеенные флаги: -rf и разгадка -ma

Короткие флаги можно склеивать. rm -rf папка — это ровно то же, что rm -r -f папка. А ls -la — это ls -l -a. Поэтому tar -xzvf — не одно загадочное слово, а четыре флага: x, z, v, f.

Теперь загадка из начала. В git commit -am "fix login" склеены два флага:

  • -a — переключатель: «добавь все изменённые файлы»;
  • -m — флаг со значением: «вот сообщение коммита».

Значение -m берёт то, что идёт после него. В -am после m ничего нет, поэтому сообщением становится следующее слово, "fix login". Всё верно.

А в -ma сразу после m стоит буква a. И git честно решает: сообщение коммита — это «a». А "fix login" остаётся лишним словом, и git думает, что это имя файла. Отсюда и ошибка.

Правило на всю жизнь: флаг со значением в склейке ставь последним. Так работают -am, tar -czf архив.tar.gz и ssh-keygen -t ed25519.

Одна буква — разные смыслы

Вторая ловушка. У флагов нет общего словаря. Каждая программа решает сама, что значит её буква.

  • -v у node -v — версия. У cp -v — «рассказывай, что делаешь». А у grep -v — «покажи строки, где совпадения нет».
  • -h во многих программах — справка. Но у ls -lh и df -h это «размеры по-человечески», в КБ и МБ. А grep -h убирает имена файлов из вывода.
  • -r у rm и cp — рекурсивно, со всеми вложенными папками. А у sort -r — в обратном порядке.

Поэтому не переноси флаг из одной команды в другую по памяти. Это частая ошибка и людей, и ИИ: модель помнит флаг из похожей программы или из старой версии. Если флаг незнакомый, проверь его за десять секунд — как, рассказали в гайде как читать справку команды.

Двойной дефис -- и одинокий дефис -

Два знака, которые выглядят как опечатка, но очень полезны.

-- значит «флаги кончились». Всё после него — обычные аргументы, даже если начинается с дефиса. Представь, что у тебя случайно появился файл с именем -rf. Команда rm -rf его не удалит: она прочитает это как флаги. А так сработает:

rm -- -rf

Мы проверили: файл удалился, остальные остались на месте. Тот же -- встречается в git checkout -- файл и в npm run dev -- --port 4000. Во втором случае всё после -- npm не трогает, а передаёт твоему скрипту.

Одинокий - часто значит «читай не из файла, а из входа». Например, cat - ждёт текст с клавиатуры или из трубы. Что такое этот вход, мы объясняли в статье что такое stdin.

Частые вопросы

--port=4000 или --port 4000 — есть разница?

Для большинства программ нет: оба варианта понимаются одинаково. Знак = надёжнее, когда значение начинается с дефиса или когда команду собирает скрипт.

Важен ли порядок флагов?

Обычно нет: ls -a -l и ls -l -a одинаковы. Важен он в склейках (флаг со значением в конце) и в командах с подкомандами: у git флаги до commit и после commit относятся к разным вещам.

Почему ИИ иногда даёт флаг, которого нет?

Модель могла запомнить флаг из другой программы или из старой версии этой. Если команда ругается на unknown option, вставь ИИ вывод --help своей версии и попроси переписать команду по нему.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →