[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/errors/macos/zsh-invalid-command":3,"mdc-dddhxm-key":625,"mdc--yap9pu-key":642,"mdc--qsdv8q-key":659,"mdc-1ma27x-key":687,"mdc-pc5hnu-key":732,"mdc--rx8msp-key":749,"mdc-811bx5-key":766,"related-/errors/macos/zsh-command-not-found,/guides/macos/change-default-shell-macos,/guides/macos/install-homebrew-macos":790},{"id":4,"title":5,"appliesTo":6,"author":10,"body":11,"canonical":564,"code":43,"createdAt":565,"description":566,"difficulty":567,"draft":568,"estimatedTime":569,"extension":570,"faq":571,"howToSteps":581,"howToTotalTime":594,"image":564,"keywords":595,"locale":604,"meta":605,"navigation":606,"path":607,"platform":608,"related":609,"section":613,"seo":614,"severity":615,"stem":616,"summary":617,"tags":618,"twitterCreator":564,"twitterSite":564,"type":623,"updatedAt":565,"__hash__":624},"content_ru/errors/macos/zsh-invalid-command.md","Ошибка 'zsh: invalid command' в macOS: причины и быстрое исправление",[7,8,9],"macOS Sonoma 14.x","macOS Ventura 13.x","Zsh 5.8+","FixPedia Team",{"type":12,"value":13,"toc":551},"minimark",[14,23,37,65,68,89,96,100,105,161,165,170,176,260,276,279,283,289,344,348,354,388,392,395,467,471,477,547],[15,16,18,19],"h2",{"id":17},"что-означает-ошибка-zsh-invalid-command","Что означает ошибка ",[20,21,22],"code",{},"zsh: invalid command",[24,25,26,27,32,33,36],"p",{},"Ошибка ",[28,29,30],"strong",{},[20,31,22],{}," (или ",[20,34,35],{},"zsh: command not found",") появляется в терминале macOS при попытке выполнить команду, которую оболочка Zsh не может распознать или найти. Полный текст может выглядеть так:",[38,39,44],"pre",{"className":40,"code":41,"language":42,"meta":43,"style":43},"language-zsh shiki shiki-themes github-light github-dark","zsh: invalid command: 'git'\n","zsh","",[20,45,46],{"__ignoreMap":43},[47,48,51,55,59,62],"span",{"class":49,"line":50},"line",1,[47,52,54],{"class":53},"sScJk","zsh:",[47,56,58],{"class":57},"sZZnC"," invalid",[47,60,61],{"class":57}," command:",[47,63,64],{"class":57}," 'git'\n",[24,66,67],{},"или",[38,69,71],{"className":40,"code":70,"language":42,"meta":43,"style":43},"zsh: command not found: npm\n",[20,72,73],{"__ignoreMap":43},[47,74,75,77,80,83,86],{"class":49,"line":50},[47,76,54],{"class":53},[47,78,79],{"class":57}," command",[47,81,82],{"class":57}," not",[47,84,85],{"class":57}," found:",[47,87,88],{"class":57}," npm\n",[24,90,91,92,95],{},"Эта ошибка означает, что Zsh не может найти исполняемый файл указанной команды в директориях, перечисленных в переменной окружения ",[20,93,94],{},"PATH",", либо команда была переопределена некорректным алиасом или функцией. Проблема возникает сразу после ввода команды и блокирует выполнение любой задачи, требующей использования терминала — от установки ПО через Homebrew до работы с Git.",[15,97,99],{"id":98},"причины-возникновения","Причины возникновения",[24,101,26,102,104],{},[20,103,22],{}," обычно вызвана одной из следующих причин:",[106,107,108,122,140,149,155],"ol",{},[109,110,111,117,118,121],"li",{},[28,112,113,114,116],{},"Искажённая переменная ",[20,115,94],{},"."," Самый частый случай. Системные пути (например, ",[20,119,120],{},"/usr/bin",", где находятся стандартные утилиты) отсутствуют или идут после путей пользователя, что мешает Zsh найти встроенные команды.",[109,123,124,127,128,131,132,135,136,139],{},[28,125,126],{},"Конфликт алиасов (alias)."," В файле ",[20,129,130],{},"~/.zshrc"," или ",[20,133,134],{},"~/.zprofile"," может быть определён алиас с именем стандартной команды (например, ",[20,137,138],{},"alias ls='ls -la'","), но с синтаксической ошибкой или конфликтующим определением.",[109,141,142,145,146,148],{},[28,143,144],{},"Повреждённый или пустой файл конфигурации Zsh."," Если файл ",[20,147,130],{}," содержит синтаксические ошибки (незакрытые кавычки, неправильный синтаксис функций), Zsh может прервать загрузку и не настроить переменные окружения корректно.",[109,150,151,154],{},[28,152,153],{},"Удаление или перемещение исполняемого файла."," Команда была установлена (например, через Homebrew), но затем файл был удалён или перемещён вручную.",[109,156,157,160],{},[28,158,159],{},"Проблема с обновлением macOS."," После крупного обновления системы стандартные пути могут быть сброшены, а старые конфигурационные файлы становятся несовместимыми с новой версией Zsh.",[15,162,164],{"id":163},"способы-решения","Способы решения",[166,167,169],"h3",{"id":168},"способ-1-проверка-и-восстановление-переменной-path","Способ 1: Проверка и восстановление переменной PATH",[24,171,172,173,175],{},"Первым делом нужно убедиться, что в переменной ",[20,174,94],{}," присутствуют стандартные системные директории.",[106,177,178,181,204,215,248],{},[109,179,180],{},"Откройте Терминал.",[109,182,183,184,186,187],{},"Выведите текущее значение ",[20,185,94],{},":\n",[38,188,192],{"className":189,"code":190,"language":191,"meta":43,"style":43},"language-bash shiki shiki-themes github-light github-dark","echo $PATH\n","bash",[20,193,194],{"__ignoreMap":43},[47,195,196,200],{"class":49,"line":50},[47,197,199],{"class":198},"sj4cs","echo",[47,201,203],{"class":202},"sVt8B"," $PATH\n",[109,205,206,207],{},"Обычный вывод для macOS должен содержать как минимум следующие пути (порядок может отличаться):\n",[38,208,213],{"className":209,"code":211,"language":212},[210],"language-text","/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin\n","text",[20,214,211],{"__ignoreMap":43},[109,216,217,218,221,222],{},"Если пути отсутствуют или выглядят подозрительно (например, начинаются с ",[20,219,220],{},"~/"," или содержат только кастомные пути), временно добавьте недостающие:\n",[38,223,225],{"className":189,"code":224,"language":191,"meta":43,"style":43},"export PATH=\"/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$PATH\"\n",[20,226,227],{"__ignoreMap":43},[47,228,229,233,236,239,242,245],{"class":49,"line":50},[47,230,232],{"class":231},"szBVR","export",[47,234,235],{"class":202}," PATH",[47,237,238],{"class":231},"=",[47,240,241],{"class":57},"\"/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:",[47,243,244],{"class":202},"$PATH",[47,246,247],{"class":57},"\"\n",[109,249,250,251,131,253,255,256,259],{},"После этого попробуйте выполнить проблемную команду снова. Если она заработала, нужно внести исправление в конфигурационный файл Zsh (",[20,252,130],{},[20,254,134],{},"), добавив туда строку ",[20,257,258],{},"export PATH=..."," из шага 4.",[261,262,263],"blockquote",{},[24,264,265,266,269,270,272,273,275],{},"⚠️ ",[28,267,268],{},"Важно:"," Изменение ",[20,271,94],{}," через ",[20,274,232],{}," действует только в текущем сеансе терминала. Для постоянного исправления отредактируйте конфигурационный файл.",[277,278],"in-article-ad",{},[166,280,282],{"id":281},"способ-2-диагностика-и-очистка-алиасов","Способ 2: Диагностика и очистка алиасов",[24,284,285,286,288],{},"Если ",[20,287,94],{}," в порядке, проблема может быть в конфликтующем алиасе.",[106,290,291,303,313,332,335],{},[109,292,293,294],{},"Покажите список всех активных алиасов:\n",[38,295,297],{"className":189,"code":296,"language":191,"meta":43,"style":43},"alias\n",[20,298,299],{"__ignoreMap":43},[47,300,301],{"class":49,"line":50},[47,302,296],{"class":198},[109,304,305,306,131,309,312],{},"Найдите в выводе алиас, имя которого совпадает с проблемной командой (например, ",[20,307,308],{},"git",[20,310,311],{},"ls",").",[109,314,315,316,318,319],{},"Временно удалите проблемный алиас (например, для ",[20,317,308],{},"):\n",[38,320,322],{"className":189,"code":321,"language":191,"meta":43,"style":43},"unalias git\n",[20,323,324],{"__ignoreMap":43},[47,325,326,329],{"class":49,"line":50},[47,327,328],{"class":198},"unalias",[47,330,331],{"class":57}," git\n",[109,333,334],{},"Попробуйте снова выполнить оригинальную команду. Если она сработала, значит, ошибка была в определении алиаса.",[109,336,337,338,341,342,116],{},"Для постоянного исправления найдите и исправьте или удалите строку с ",[20,339,340],{},"alias"," в файле ",[20,343,130],{},[166,345,347],{"id":346},"способ-3-проверка-конфигурационных-файлов-на-синтаксис","Способ 3: Проверка конфигурационных файлов на синтаксис",[24,349,350,351,353],{},"Повреждённый ",[20,352,130],{}," может полностью нарушить загрузку оболочки.",[106,355,356,375,380,385],{},[109,357,358,359],{},"Временно переименуйте основной конфигурационный файл, чтобы Zsh загрузилась с настройками по умолчанию:\n",[38,360,362],{"className":189,"code":361,"language":191,"meta":43,"style":43},"mv ~/.zshrc ~/.zshrc.broken\n",[20,363,364],{"__ignoreMap":43},[47,365,366,369,372],{"class":49,"line":50},[47,367,368],{"class":53},"mv",[47,370,371],{"class":57}," ~/.zshrc",[47,373,374],{"class":57}," ~/.zshrc.broken\n",[109,376,377,378,312],{},"Запустите новую сессию Zsh (откройте новое окно терминала или выполните ",[20,379,42],{},[109,381,382,383,116],{},"Попробуйте выполнить проблемную команду. Если она работает, значит, ошибка была в старом ",[20,384,130],{},[109,386,387],{},"Восстановите старый файл и проверьте его на синтаксические ошибки. Лучший способ — создать новый чистый файл и переносить в него настройки по одной, проверяя работоспособность после каждого изменения.",[166,389,391],{"id":390},"способ-4-полная-переустановка-zsh","Способ 4: Полная переустановка Zsh",[24,393,394],{},"Если ни один из предыдущих способов не помог, возможно, сам бинарник Zsh или его системные файлы повреждены.",[106,396,397,419],{},[109,398,399,402,418],{},[28,400,401],{},"Если Zsh был установлен через Homebrew:",[38,403,405],{"className":189,"code":404,"language":191,"meta":43,"style":43},"brew reinstall zsh\n",[20,406,407],{"__ignoreMap":43},[47,408,409,412,415],{"class":49,"line":50},[47,410,411],{"class":53},"brew",[47,413,414],{"class":57}," reinstall",[47,416,417],{"class":57}," zsh\n","\nЭта команда переустановит Zsh и обновит пути.",[109,420,421,424,425,463,464,466],{},[28,422,423],{},"Если используется системная Zsh:"," Восстановите стандартные конфигурационные файлы. Переместите все скрытые файлы Zsh в папку для бэкапа:\n",[38,426,428],{"className":189,"code":427,"language":191,"meta":43,"style":43},"mkdir -p ~/zsh_backup\nmv ~/.zshrc ~/.zprofile ~/.zshrc.zwc ~/zsh_backup/ 2>/dev/null\n",[20,429,430,441],{"__ignoreMap":43},[47,431,432,435,438],{"class":49,"line":50},[47,433,434],{"class":53},"mkdir",[47,436,437],{"class":198}," -p",[47,439,440],{"class":57}," ~/zsh_backup\n",[47,442,444,446,448,451,454,457,460],{"class":49,"line":443},2,[47,445,368],{"class":53},[47,447,371],{"class":57},[47,449,450],{"class":57}," ~/.zprofile",[47,452,453],{"class":57}," ~/.zshrc.zwc",[47,455,456],{"class":57}," ~/zsh_backup/",[47,458,459],{"class":231}," 2>",[47,461,462],{"class":57},"/dev/null\n","\nПосле этого откройте новое окно терминала. Zsh создаст минимальные конфигурационные файлы по умолчанию. Проверьте, работает ли стандартная команда (например, ",[20,465,311],{},"). Если да — настройте Zsh заново, скопировав нужные настройки из бэкапа.",[15,468,470],{"id":469},"профилактика","Профилактика",[24,472,473,474,476],{},"Чтобы избежать появления ошибки ",[20,475,22],{}," в будущем:",[478,479,480,492,508,532,541],"ul",{},[109,481,482,487,488,491],{},[28,483,484,485,116],{},"Будьте осторожны при редактировании ",[20,486,130],{}," Всегда делайте бэкап файла перед изменениями (",[20,489,490],{},"cp ~/.zshrc ~/.zshrc.backup","). Проверяйте синтаксис после правки.",[109,493,494,497,498,500,501,500,504,507],{},[28,495,496],{},"Не переопределяйте системные команды"," (например, ",[20,499,311],{},", ",[20,502,503],{},"cat",[20,505,506],{},"rm",") через алиасы без необходимости. Если нужно — используйте уникальные имена.",[109,509,510,513,514,131,517,520,521,523,524,527,528,531],{},[28,511,512],{},"При использовании менеджеров пакетов (Homebrew, MacPorts)"," убедитесь, что их пути (",[20,515,516],{},"/opt/homebrew/bin",[20,518,519],{},"/usr/local/bin",") добавлены в ",[20,522,94],{}," ",[28,525,526],{},"после"," системных, но ",[28,529,530],{},"до"," пользовательских, чтобы избежать конфликтов.",[109,533,534,537,538,540],{},[28,535,536],{},"После обновления macOS"," проверьте работоспособность терминала и наличие критических путей в ",[20,539,94],{},". Обновляйте конфигурационные файлы Zsh в соответствии с новой версией.",[109,542,543,546],{},[28,544,545],{},"Устанавливайте команды только из доверенных источников"," (официальные сайты, Homebrew). Избегайте ручного копирования бинарных файлов в системные директории.",[548,549,550],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":43,"searchDepth":443,"depth":443,"links":552},[553,555,556,563],{"id":17,"depth":443,"text":554},"Что означает ошибка zsh: invalid command",{"id":98,"depth":443,"text":99},{"id":163,"depth":443,"text":164,"children":557},[558,560,561,562],{"id":168,"depth":559,"text":169},3,{"id":281,"depth":559,"text":282},{"id":346,"depth":559,"text":347},{"id":390,"depth":559,"text":391},{"id":469,"depth":443,"text":470},null,"2026-02-17 15:01:39","Пошаговая инструкция по исправлению ошибки 'zsh: invalid command' в терминале macOS. Проверенные способы восстановления работоспособности оболочки Zsh за 5-10 минут.","easy",false,"5-10 мин","md",[572,575,578],{"question":573,"answer":574},"В чём разница между ошибками 'zsh: invalid command' и 'zsh: command not found'?","Ошибка 'invalid command' обычно возникает при попытке выполнить команду, синтаксис которой Zsh не распознаёт (например, из-за конфликта алиаса или опечатки). 'Command not found' означает, что система вообще не нашла исполняемый файл в путях, указанных в переменной `PATH`.",{"question":576,"answer":577},"Могу ли я использовать Bash вместо Zsh, чтобы избежать этой ошибки?","Да, вы можете временно или постоянно переключиться на Bash (`chsh -s /bin/bash`), но Zsh — это современная и более функциональная оболочка по умолчанию в macOS. Рекомендуется устранять причину ошибки в Zsh.",{"question":579,"answer":580},"Почему после обновления macOS начали появляться такие ошибки?","Обновление системы может сбросить или изменить системные пути (`PATH`), а также обновить версию Zsh, что приводит к несовместимости старых конфигурационных файлов (`~/.zshrc`, `~/.zprofile`).",[582,585,588,591],{"name":583,"text":584},"Проверьте переменную PATH","Убедитесь, что системные пути (например, `/usr/bin`, `/bin`, `/usr/sbin`) присутствуют в переменной `PATH`. Выполните `echo $PATH` и проверьте вывод.",{"name":586,"text":587},"Временно перезагрузите конфигурацию Zsh","Выполните команду `source ~/.zshrc` или откройте новое окно терминала, чтобы применить изменения после редактирования конфигурационных файлов.",{"name":589,"text":590},"Проверьте алиасы и функции","Временно отключите все алиасы командой `unalias -a` и попробуйте выполнить проблемную команду снова. Если ошибка исчезнет, проблема в конфликтующем алиасе.",{"name":592,"text":593},"Полная переустановка Zsh","Если ничего не помогает, переустановите Zsh через Homebrew (`brew reinstall zsh`) или восстановите стандартные конфигурационные файлы, переместив старые (`mv ~/.zshrc ~/.zshrc.backup`).","PT10M",[596,597,598,599,600,35,601,602,603],"zsh invalid command","ошибка zsh команда не найдена","macos zsh команда не работает","исправить zsh invalid command","терминал mac zsh ошибка","почему не работает zsh на mac","переменная PATH zsh mac","алиасы zsh ошибка","ru_RU",{},true,"/errors/macos/zsh-invalid-command","macos",[610,611,612],"/errors/macos/zsh-command-not-found","/guides/macos/change-default-shell-macos","/guides/macos/install-homebrew-macos","Ошибки macOS",{"title":5,"description":566},"medium","errors/macos/zsh-invalid-command","Статья объясняет, почему в терминале macOS появляется сообщение 'zsh: invalid command', и предоставляет 4 рабочих способа решения проблемы — от простой проверки переменной PATH до полной переустановки Zsh.",[608,42,619,620,621,191,622],"терминал","ошибка","command-line","shell","error","g7Z2CuDe-sH1cFD3FN3H6sljIekKeSMZQVRtQ8b2iDo",{"data":626,"body":627},{},{"type":628,"children":629},"root",[630],{"type":631,"tag":24,"props":632,"children":633},"element",{},[634,636,641],{"type":212,"value":635},"Ошибка 'invalid command' обычно возникает при попытке выполнить команду, синтаксис которой Zsh не распознаёт (например, из-за конфликта алиаса или опечатки). 'Command not found' означает, что система вообще не нашла исполняемый файл в путях, указанных в переменной ",{"type":631,"tag":20,"props":637,"children":639},{"className":638},[],[640],{"type":212,"value":94},{"type":212,"value":116},{"data":643,"body":644},{},{"type":628,"children":645},[646],{"type":631,"tag":24,"props":647,"children":648},{},[649,651,657],{"type":212,"value":650},"Да, вы можете временно или постоянно переключиться на Bash (",{"type":631,"tag":20,"props":652,"children":654},{"className":653},[],[655],{"type":212,"value":656},"chsh -s /bin/bash",{"type":212,"value":658},"), но Zsh — это современная и более функциональная оболочка по умолчанию в macOS. Рекомендуется устранять причину ошибки в Zsh.",{"data":660,"body":661},{},{"type":628,"children":662},[663],{"type":631,"tag":24,"props":664,"children":665},{},[666,668,673,675,680,681,686],{"type":212,"value":667},"Обновление системы может сбросить или изменить системные пути (",{"type":631,"tag":20,"props":669,"children":671},{"className":670},[],[672],{"type":212,"value":94},{"type":212,"value":674},"), а также обновить версию Zsh, что приводит к несовместимости старых конфигурационных файлов (",{"type":631,"tag":20,"props":676,"children":678},{"className":677},[],[679],{"type":212,"value":130},{"type":212,"value":500},{"type":631,"tag":20,"props":682,"children":684},{"className":683},[],[685],{"type":212,"value":134},{"type":212,"value":312},{"data":688,"body":689},{},{"type":628,"children":690},[691],{"type":631,"tag":24,"props":692,"children":693},{},[694,696,701,702,708,709,715,717,722,724,730],{"type":212,"value":695},"Убедитесь, что системные пути (например, ",{"type":631,"tag":20,"props":697,"children":699},{"className":698},[],[700],{"type":212,"value":120},{"type":212,"value":500},{"type":631,"tag":20,"props":703,"children":705},{"className":704},[],[706],{"type":212,"value":707},"/bin",{"type":212,"value":500},{"type":631,"tag":20,"props":710,"children":712},{"className":711},[],[713],{"type":212,"value":714},"/usr/sbin",{"type":212,"value":716},") присутствуют в переменной ",{"type":631,"tag":20,"props":718,"children":720},{"className":719},[],[721],{"type":212,"value":94},{"type":212,"value":723},". Выполните ",{"type":631,"tag":20,"props":725,"children":727},{"className":726},[],[728],{"type":212,"value":729},"echo $PATH",{"type":212,"value":731}," и проверьте вывод.",{"data":733,"body":734},{},{"type":628,"children":735},[736],{"type":631,"tag":24,"props":737,"children":738},{},[739,741,747],{"type":212,"value":740},"Выполните команду ",{"type":631,"tag":20,"props":742,"children":744},{"className":743},[],[745],{"type":212,"value":746},"source ~/.zshrc",{"type":212,"value":748}," или откройте новое окно терминала, чтобы применить изменения после редактирования конфигурационных файлов.",{"data":750,"body":751},{},{"type":628,"children":752},[753],{"type":631,"tag":24,"props":754,"children":755},{},[756,758,764],{"type":212,"value":757},"Временно отключите все алиасы командой ",{"type":631,"tag":20,"props":759,"children":761},{"className":760},[],[762],{"type":212,"value":763},"unalias -a",{"type":212,"value":765}," и попробуйте выполнить проблемную команду снова. Если ошибка исчезнет, проблема в конфликтующем алиасе.",{"data":767,"body":768},{},{"type":628,"children":769},[770],{"type":631,"tag":24,"props":771,"children":772},{},[773,775,781,783,789],{"type":212,"value":774},"Если ничего не помогает, переустановите Zsh через Homebrew (",{"type":631,"tag":20,"props":776,"children":778},{"className":777},[],[779],{"type":212,"value":780},"brew reinstall zsh",{"type":212,"value":782},") или восстановите стандартные конфигурационные файлы, переместив старые (",{"type":631,"tag":20,"props":784,"children":786},{"className":785},[],[787],{"type":212,"value":788},"mv ~/.zshrc ~/.zshrc.backup",{"type":212,"value":312},[791],{"id":792,"title":793,"appliesTo":794,"author":10,"body":797,"canonical":564,"code":1469,"createdAt":1470,"description":1471,"difficulty":567,"draft":568,"estimatedTime":569,"extension":570,"faq":1472,"howToSteps":1485,"howToTotalTime":1497,"image":564,"keywords":1498,"locale":604,"meta":1509,"navigation":606,"path":610,"platform":608,"related":1510,"section":613,"seo":1513,"severity":615,"stem":1514,"summary":1515,"tags":1516,"twitterCreator":564,"twitterSite":564,"type":623,"updatedAt":1470,"__hash__":1523},"content_ru/errors/macos/zsh-command-not-found.md","Ошибка 'command not found' в zsh: как исправить на macOS",[795,796],"macOS 10.15+","zsh 5.0+",{"type":12,"value":798,"toc":1458},[799,803,810,828,834,836,890,894,897,993,997,1005,1158,1162,1165,1195,1199,1202,1252,1258,1260,1264,1267,1322,1326,1332,1345,1348,1361,1371,1373,1379,1452,1455],[15,800,802],{"id":801},"что-означает-ошибка-command-not-found-в-zsh","Что означает ошибка 'command not found' в zsh",[24,804,26,805,809],{},[28,806,807],{},[20,808,35],{}," возникает, когда оболочка zsh не может найти исполняемый файл команды, которую вы пытаетесь выполнить. Полный текст ошибки выглядит так:",[38,811,813],{"className":189,"code":812,"language":191,"meta":43,"style":43},"zsh: command not found: имя_команды\n",[20,814,815],{"__ignoreMap":43},[47,816,817,819,821,823,825],{"class":49,"line":50},[47,818,54],{"class":53},[47,820,79],{"class":57},[47,822,82],{"class":57},[47,824,85],{"class":57},[47,826,827],{"class":57}," имя_команды\n",[24,829,830,831,833],{},"Она появляется в терминале macOS при вводе команды, которая либо не установлена в системе, либо её путь не прописан в переменной окружения ",[20,832,94],{},". Это распространённая проблема при настройке нового Mac или после установки дополнительных инструментов.",[15,835,99],{"id":98},[106,837,838,852,862,874,884],{},[109,839,840,843,844,500,846,500,849,312],{},[28,841,842],{},"Команда не установлена"," — вы пытаетесь запустить утилиту, которую ещё не добавили в систему (например, ",[20,845,308],{},[20,847,848],{},"node",[20,850,851],{},"docker",[109,853,854,859,860,116],{},[28,855,856,857],{},"Путь к команде отсутствует в ",[20,858,94],{}," — команда установлена, но директория с её исполняемым файлом не добавлена в переменную ",[20,861,94],{},[109,863,864,867,868,871,872,312],{},[28,865,866],{},"Опечатка в имени команды"," — случайная ошибка при вводе (например, ",[20,869,870],{},"gti"," вместо ",[20,873,308],{},[109,875,876,879,880,883],{},[28,877,878],{},"Конфликт оболочек"," — команда настроена только для bash (через ",[20,881,882],{},"~/.bash_profile","), но не для zsh.",[109,885,886,889],{},[28,887,888],{},"Повреждение кэша zsh"," — иногда zsh не обновляет список доступных команд после установки нового ПО.",[15,891,893],{"id":892},"способ-1-проверьте-установлена-ли-команда","Способ 1: Проверьте, установлена ли команда",[24,895,896],{},"Первым делом убедитесь, что команда вообще присутствует в системе.",[106,898,899,931],{},[109,900,901,911,912,923,926,927,930],{},[28,902,903,904,131,907,910],{},"Используйте ",[20,905,906],{},"which",[20,908,909],{},"type"," для поиска",":",[38,913,915],{"className":189,"code":914,"language":191,"meta":43,"style":43},"which имя_команды\n",[20,916,917],{"__ignoreMap":43},[47,918,919,921],{"class":49,"line":50},[47,920,906],{"class":198},[47,922,827],{"class":57},[924,925],"br",{},"Если команда найдена, вы увидите полный путь к исполняемому файлу (например, ",[20,928,929],{},"/usr/local/bin/git","). Если нет — команда не установлена.",[109,932,933,936,937],{},[28,934,935],{},"Установите команду",", если её нет:",[478,938,939,961,983],{},[109,940,941,942,945,946],{},"Через ",[28,943,944],{},"Homebrew"," (рекомендуется):\n",[38,947,949],{"className":189,"code":948,"language":191,"meta":43,"style":43},"brew install имя_пакета\n",[20,950,951],{"__ignoreMap":43},[47,952,953,955,958],{"class":49,"line":50},[47,954,411],{"class":53},[47,956,957],{"class":57}," install",[47,959,960],{"class":57}," имя_пакета\n",[109,962,941,963,186,966],{},[28,964,965],{},"MacPorts",[38,967,969],{"className":189,"code":968,"language":191,"meta":43,"style":43},"sudo port install имя_пакета\n",[20,970,971],{"__ignoreMap":43},[47,972,973,976,979,981],{"class":49,"line":50},[47,974,975],{"class":53},"sudo",[47,977,978],{"class":57}," port",[47,980,957],{"class":57},[47,982,960],{"class":57},[109,984,985,986,312],{},"Или скачайте установщик с официального сайта (например, для ",[987,988,992],"a",{"href":989,"rel":990},"https://git-scm.com/",[991],"nofollow","Git",[15,994,996],{"id":995},"способ-2-проверьте-и-исправьте-переменную-path","Способ 2: Проверьте и исправьте переменную PATH",[24,998,999,1000,1002,1003,116],{},"Если команда установлена, но ",[20,1001,906],{}," не находит её, проблема в переменной ",[20,1004,94],{},[106,1006,1007,1030,1068,1143],{},[109,1008,1009,911,1014,1024,1026,1027,312],{},[28,1010,1011,1012],{},"Просмотрите текущий ",[20,1013,94],{},[38,1015,1016],{"className":189,"code":190,"language":191,"meta":43,"style":43},[20,1017,1018],{"__ignoreMap":43},[47,1019,1020,1022],{"class":49,"line":50},[47,1021,199],{"class":198},[47,1023,203],{"class":202},[924,1025],{},"Вывод будет списком директорий, разделённых двоеточиями (например, ",[20,1028,1029],{},"/usr/local/bin:/usr/bin:/bin",[109,1031,1032,911,1035,1060,1062,1063,131,1065,116],{},[28,1033,1034],{},"Найдите, где установлена команда",[38,1036,1038],{"className":189,"code":1037,"language":191,"meta":43,"style":43},"sudo find / -name \"имя_команды\" 2>/dev/null\n",[20,1039,1040],{"__ignoreMap":43},[47,1041,1042,1044,1047,1050,1053,1056,1058],{"class":49,"line":50},[47,1043,975],{"class":53},[47,1045,1046],{"class":57}," find",[47,1048,1049],{"class":57}," /",[47,1051,1052],{"class":198}," -name",[47,1054,1055],{"class":57}," \"имя_команды\"",[47,1057,459],{"class":231},[47,1059,462],{"class":57},[924,1061],{},"Это покажет все файлы с таким именем. Обычно пользовательские утилиты хранятся в ",[20,1064,519],{},[20,1066,1067],{},"~/bin",[109,1069,1070,911,1075],{},[28,1071,1072,1073],{},"Добавьте недостающую директорию в ",[20,1074,94],{},[478,1076,1077,1095,1118],{},[109,1078,1079,1080,318,1082],{},"Откройте файл конфигурации zsh (обычно ",[20,1081,130],{},[38,1083,1085],{"className":189,"code":1084,"language":191,"meta":43,"style":43},"nano ~/.zshrc\n",[20,1086,1087],{"__ignoreMap":43},[47,1088,1089,1092],{"class":49,"line":50},[47,1090,1091],{"class":53},"nano",[47,1093,1094],{"class":57}," ~/.zshrc\n",[109,1096,1097,1098,1101,1102],{},"Добавьте строку (замените ",[20,1099,1100],{},"/путь/к/директории"," на найденный путь):\n",[38,1103,1105],{"className":189,"code":1104,"language":191,"meta":43,"style":43},"export PATH=$PATH:/путь/к/директории\n",[20,1106,1107],{"__ignoreMap":43},[47,1108,1109,1111,1113,1115],{"class":49,"line":50},[47,1110,232],{"class":231},[47,1112,235],{"class":202},[47,1114,238],{"class":231},[47,1116,1117],{"class":202},"$PATH:/путь/к/директории\n",[109,1119,1120,1121,500,1124,500,1127,1130,1131],{},"Сохраните файл (",[20,1122,1123],{},"Ctrl+O",[20,1125,1126],{},"Enter",[20,1128,1129],{},"Ctrl+X",") и примените изменения:\n",[38,1132,1134],{"className":189,"code":1133,"language":191,"meta":43,"style":43},"source ~/.zshrc\n",[20,1135,1136],{"__ignoreMap":43},[47,1137,1138,1141],{"class":49,"line":50},[47,1139,1140],{"class":198},"source",[47,1142,1094],{"class":57},[109,1144,1145,911,1148],{},[28,1146,1147],{},"Проверьте, что команда теперь работает",[38,1149,1150],{"className":189,"code":914,"language":191,"meta":43,"style":43},[20,1151,1152],{"__ignoreMap":43},[47,1153,1154,1156],{"class":49,"line":50},[47,1155,906],{"class":198},[47,1157,827],{"class":57},[15,1159,1161],{"id":1160},"способ-3-проверьте-опечатки-и-регистр","Способ 3: Проверьте опечатки и регистр",[24,1163,1164],{},"Иногда ошибка возникает из-за простой опечатки. Убедитесь, что команда написана правильно:",[478,1166,1167,1175,1178],{},[109,1168,1169,1170,1172,1173,116],{},"Регистр имеет значение: ",[20,1171,992],{}," ≠ ",[20,1174,308],{},[109,1176,1177],{},"Нет ли лишних символов или пробелов.",[109,1179,1180,1181,186,1183,1194],{},"Для проверки используйте ",[20,1182,909],{},[38,1184,1186],{"className":189,"code":1185,"language":191,"meta":43,"style":43},"type имя_команды\n",[20,1187,1188],{"__ignoreMap":43},[47,1189,1190,1192],{"class":49,"line":50},[47,1191,909],{"class":198},[47,1193,827],{"class":57},"\nЕсли команда не найдена, zsh покажет ошибку. Если найдена — выведет тип (alias, function, builtin и т.д.).",[15,1196,1198],{"id":1197},"способ-4-переустановите-команду-через-менеджер-пакетов","Способ 4: Переустановите команду через менеджер пакетов",[24,1200,1201],{},"Если команда была установлена через Homebrew или MacPorts, но перестала работать, попробуйте переустановить:",[478,1203,1204,1232],{},[109,1205,1206,186,1208],{},[28,1207,944],{},[38,1209,1211],{"className":189,"code":1210,"language":191,"meta":43,"style":43},"brew reinstall имя_пакета\nbrew cleanup  # удаляет старые версии\n",[20,1212,1213,1221],{"__ignoreMap":43},[47,1214,1215,1217,1219],{"class":49,"line":50},[47,1216,411],{"class":53},[47,1218,414],{"class":57},[47,1220,960],{"class":57},[47,1222,1223,1225,1228],{"class":49,"line":443},[47,1224,411],{"class":53},[47,1226,1227],{"class":57}," cleanup",[47,1229,1231],{"class":1230},"sJ8bj","  # удаляет старые версии\n",[109,1233,1234,186,1236],{},[28,1235,965],{},[38,1237,1239],{"className":189,"code":1238,"language":191,"meta":43,"style":43},"sudo port upgrade имя_пакета\n",[20,1240,1241],{"__ignoreMap":43},[47,1242,1243,1245,1247,1250],{"class":49,"line":50},[47,1244,975],{"class":53},[47,1246,978],{"class":57},[47,1248,1249],{"class":57}," upgrade",[47,1251,960],{"class":57},[24,1253,1254,1255,1257],{},"После переустановки проверьте ",[20,1256,94],{}," (Способ 2) — иногда менеджеры пакетов добавляют пути автоматически.",[277,1259],{},[15,1261,1263],{"id":1262},"способ-5-обновите-кэш-оболочки","Способ 5: Обновите кэш оболочки",[24,1265,1266],{},"Zsh кэширует расположение команд. Если вы установили новую утилиту, но zsh её не видит, обновите кэш:",[106,1268,1269,1289,1295],{},[109,1270,1271,911,1277,1286,1288],{},[28,1272,1273,1274],{},"Выполните ",[20,1275,1276],{},"rehash",[38,1278,1280],{"className":189,"code":1279,"language":191,"meta":43,"style":43},"rehash\n",[20,1281,1282],{"__ignoreMap":43},[47,1283,1284],{"class":49,"line":50},[47,1285,1279],{"class":53},[924,1287],{},"Это принудительно обновит список команд.",[109,1290,1291,1294],{},[28,1292,1293],{},"Или перезапустите терминал"," — иногда достаточно просто закрыть и снова открыть окно терминала.",[109,1296,1297,1300,1301],{},[28,1298,1299],{},"Если проблема осталась",", проверьте, нет ли конфликта с файлами конфигурации:",[478,1302,1303,1312],{},[109,1304,1305,1306,1308,1309,312],{},"Убедитесь, что в ",[20,1307,130],{}," нет ошибок (можно проверить через ",[20,1310,1311],{},"zsh -n ~/.zshrc",[109,1313,1314,1315,1317,1318,1321],{},"Временно переименуйте ",[20,1316,130],{}," (например, в ",[20,1319,1320],{},"~/.zshrc.backup",") и перезапустите zsh. Если ошибка исчезла — проблема в конфигурации.",[15,1323,1325],{"id":1324},"способ-6-используйте-полный-путь-к-команде-временное-решение","Способ 6: Используйте полный путь к команде (временное решение)",[24,1327,1328,1329,1331],{},"Если нужно срочно выполнить команду, а настройка ",[20,1330,94],{}," займёт время, укажите полный путь:",[38,1333,1335],{"className":189,"code":1334,"language":191,"meta":43,"style":43},"/полный/путь/к/имя_команды [аргументы]\n",[20,1336,1337],{"__ignoreMap":43},[47,1338,1339,1342],{"class":49,"line":50},[47,1340,1341],{"class":53},"/полный/путь/к/имя_команды",[47,1343,1344],{"class":202}," [аргументы]\n",[24,1346,1347],{},"Например:",[38,1349,1351],{"className":189,"code":1350,"language":191,"meta":43,"style":43},"/usr/local/bin/python3 --version\n",[20,1352,1353],{"__ignoreMap":43},[47,1354,1355,1358],{"class":49,"line":50},[47,1356,1357],{"class":53},"/usr/local/bin/python3",[47,1359,1360],{"class":198}," --version\n",[24,1362,1363,1364,1366,1367,1370],{},"Чтобы узнать полный путь, используйте ",[20,1365,906],{}," (если команда установлена) или ",[20,1368,1369],{},"find"," (см. Способ 2).",[15,1372,470],{"id":469},[24,1374,1375,1376,476],{},"Чтобы избежать ошибки ",[20,1377,1378],{},"command not found",[106,1380,1381,1390,1399,1410,1435],{},[109,1382,1383,1386,1387,1389],{},[28,1384,1385],{},"Устанавливайте команды через Homebrew"," — он автоматически настраивает ",[20,1388,94],{}," для zsh.",[109,1391,1392,1398],{},[28,1393,1394,1395,1397],{},"Проверяйте ",[20,1396,94],{}," после установки нового ПО"," — убедитесь, что директория с бинарниками добавлена.",[109,1400,1401,1406,1407,1409],{},[28,1402,903,1403,1405],{},[20,1404,130],{}," для настроек"," — не редактируйте ",[20,1408,882],{}," (он не влияет на zsh).",[109,1411,1412,186,1415],{},[28,1413,1414],{},"Регулярно обновляйте Homebrew и пакеты",[38,1416,1418],{"className":189,"code":1417,"language":191,"meta":43,"style":43},"brew update && brew upgrade\n",[20,1419,1420],{"__ignoreMap":43},[47,1421,1422,1424,1427,1430,1432],{"class":49,"line":50},[47,1423,411],{"class":53},[47,1425,1426],{"class":57}," update",[47,1428,1429],{"class":202}," && ",[47,1431,411],{"class":53},[47,1433,1434],{"class":57}," upgrade\n",[109,1436,1437,1442,1443,500,1445,500,1447,500,1449,312],{},[28,1438,1439,1440],{},"Не удаляйте системные директории из ",[20,1441,94],{}," — оставьте стандартные значения (",[20,1444,120],{},[20,1446,707],{},[20,1448,714],{},[20,1450,1451],{},"/sbin",[24,1453,1454],{},"Если проблема возникает с конкретной командой, проверьте её документацию — некоторые утилиты требуют дополнительных шагов настройки.",[548,1456,1457],{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":43,"searchDepth":443,"depth":443,"links":1459},[1460,1461,1462,1463,1464,1465,1466,1467,1468],{"id":801,"depth":443,"text":802},{"id":98,"depth":443,"text":99},{"id":892,"depth":443,"text":893},{"id":995,"depth":443,"text":996},{"id":1160,"depth":443,"text":1161},{"id":1197,"depth":443,"text":1198},{"id":1262,"depth":443,"text":1263},{"id":1324,"depth":443,"text":1325},{"id":469,"depth":443,"text":470},"zsh_cmd_nf","2026-02-16 18:27:46","Пошаговая инструкция по устранению ошибки 'command not found' в zsh на macOS. Узнайте, как проверить PATH, переустановить команды и настроить оболочку. Решение за 5 минут!",[1473,1476,1479,1482],{"answer":1474,"question":1475},"Ошибка возникает, когда zsh не может найти исполняемый файл команды в директориях, указанных в переменной PATH. Это может быть из-за того, что команда не установлена, путь к ней не добавлен в PATH или команда опечатана.","Почему возникает ошибка 'command not found' в zsh?",{"answer":1477,"question":1478},"Откройте файл конфигурации zsh (обычно `~/.zshrc`) и добавьте строку `export PATH=$PATH:/путь/к/директории`. Затем выполните `source ~/.zshrc`.","Как добавить путь к команде в PATH?",{"answer":1480,"question":1481},"Проверьте, что команда находится в одной из директорий PATH. Выполните `which имя_команды` для поиска. Если команда не найдена, возможно, она установлена в нестандартную директорию, которую нужно добавить в PATH.","Что делать, если команда установлена, но всё равно не работает?",{"answer":1483,"question":1484},"Запустите команду, указав полный путь, например: `/usr/local/bin/имя_команды`.","Как временно использовать команду, не добавляя её в PATH?",[1486,1489,1491,1494],{"name":1487,"text":1488},"Проверьте, установлена ли команда","Убедитесь, что команда, которую вы пытаетесь выполнить, установлена в системе. Например, для проверки `git` выполните `which git`.",{"name":583,"text":1490},"Выполните `echo $PATH` и убедитесь, что директория, содержащая команду, есть в списке. Если нет, добавьте её.",{"name":1492,"text":1493},"Добавьте путь в PATH","Откройте файл `~/.zshrc` в текстовом редакторе и добавьте `export PATH=$PATH:/путь/к/директории`. Сохраните и выполните `source ~/.zshrc`.",{"name":1495,"text":1496},"Переустановите команду","Если команда была установлена через менеджер пакетов (Homebrew, MacPorts), переустановите её. Например, для Homebrew: `brew reinstall имя_пакета`.","PT15M",[1499,1500,1501,1502,1503,1504,1505,1506,1507,1508],"zsh command not found","ошибка command not found macos","как исправить zsh command not found","zsh: command not found решение","macos zsh команда не найдена","переменная PATH zsh","установка команд в zsh","настройка zsh на macos","ошибка оболочки zsh","command not found в терминале macos",{},[607,1511,1512],"/guides/macos/configure-zsh","/errors/macos/homebrew-command-not-found",{"title":793,"description":1471},"errors/macos/zsh-command-not-found","Статья объясняет, почему в zsh возникает ошибка 'command not found', и предлагает несколько способов её исправить. Вы узнаете, как проверить переменную PATH, переустановить недостающие утилиты и настроить оболочку.",[1517,42,1518,1519,94,1520,1521,1522],"ошибки macos","terminal","командная строка","оболочка","macos terminal","zsh config","Cy0N4jdjGmOVRCOD115Re1mS-2TijhvU2ki6Qg14UXo"]