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