Что такое флаг в команде — и почему 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 коротких урока на телефоне.





