[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/macos/configure-zsh":3,"mdc--13dw8z-key":1256,"mdc--rc5pvf-key":1267,"mdc--c34go8-key":1291,"mdc-2cmdev-key":1314,"mdc--ym84zl-key":1330,"mdc--7rfyy5-key":1347,"mdc-cye82n-key":1355,"mdc-5l8qtk-key":1384,"mdc--eq2mar-key":1426,"mdc--x17n45-key":1442,"related-/guides/macos/install-homebrew,/guides/macos/configure-iterm2,/errors/macos/zsh-syntax-error":1457},{"id":4,"title":5,"appliesTo":6,"author":8,"body":9,"canonical":1184,"code":1184,"createdAt":1185,"description":1186,"difficulty":1187,"draft":1188,"estimatedTime":1189,"extension":1190,"faq":1191,"howToSteps":1204,"howToTotalTime":1223,"image":1184,"keywords":1224,"locale":1235,"meta":1236,"navigation":1237,"path":1238,"platform":1239,"related":1240,"section":1244,"seo":1245,"severity":1184,"stem":1246,"summary":1247,"tags":1248,"twitterCreator":1184,"twitterSite":1184,"type":1254,"updatedAt":1185,"__hash__":1255},"content_ru/guides/macos/configure-zsh.md","Как настроить ZSH на macOS: полное руководство с Oh My Zsh",[7],"macOS 10.15 (Catalina) и выше","FixPedia Team",{"type":10,"value":11,"toc":1160},"minimark",[12,17,21,24,28,31,62,65,88,95,99,102,119,122,138,141,159,163,166,169,194,201,221,224,243,250,259,263,266,269,391,397,425,428,431,435,438,441,510,524,588,597,602,649,652,656,662,666,672,774,779,783,798,839,851,855,861,879,882,886,889,949,952,956,959,963,969,974,995,999,1006,1010,1035,1039,1044,1048,1076,1080,1088,1092,1116,1120,1129,1133,1144,1153,1156],[13,14,16],"h2",{"id":15},"введение","Введение",[18,19,20],"p",{},"ZSH (Z shell) – это современная и расширяемая оболочка командной строки, которая с macOS Catalina (версия 10.15) стала стандартной вместо Bash. Она предлагает множество улучшений: интеллектуальное автодополнение, поддержку тем оформления, плагинов и удобные функции вроде истории команд с поиском. Настройка ZSH позволяет значительно повысить продуктивность работы в терминале, делая его не только функциональным, но и визуально привлекательным.",[18,22,23],{},"В этом руководстве вы научитесь настраивать ZSH на macOS с помощью фреймворка Oh My Zsh, который упрощает управление конфигурацией, темами и плагинами. После выполнения вы получите персонализированный терминал, адаптированный под ваши задачи.",[13,25,27],{"id":26},"требования","Требования",[18,29,30],{},"Перед началом убедитесь, что у вас есть:",[32,33,34,42,49,55],"ul",{},[35,36,37,41],"li",{},[38,39,40],"strong",{},"macOS 10.15 (Catalina) или новее"," (ZSH предустановлен). Для более старых версий macOS может потребоваться ручная установка ZSH.",[35,43,44,45,48],{},"Доступ к ",[38,46,47],{},"Терминалу"," (Terminal) или стороннему эмулятору, например iTerm2.",[35,50,51,54],{},[38,52,53],{},"Интернет-соединение"," для загрузки Oh My Zsh и плагинов.",[35,56,57,58,61],{},"Рекомендуется установленный ",[38,59,60],{},"Homebrew"," для удобного управления пакетами, но не обязательно.",[18,63,64],{},"Если вы не уверены, есть ли ZSH, выполните в терминале:",[66,67,72],"pre",{"className":68,"code":69,"language":70,"meta":71,"style":71},"language-bash shiki shiki-themes github-light github-dark","zsh --version\n","bash","",[73,74,75],"code",{"__ignoreMap":71},[76,77,80,84],"span",{"class":78,"line":79},"line",1,[76,81,83],{"class":82},"sScJk","zsh",[76,85,87],{"class":86},"sj4cs"," --version\n",[18,89,90,91,94],{},"Если команда возвращает версию (например, ",[73,92,93],{},"zsh 5.8","), ZSH установлен. Если нет – перейдите к шагу установки в инструкции ниже.",[13,96,98],{"id":97},"шаг-1-установка-zsh-если-необходимо","Шаг 1: Установка ZSH (если необходимо)",[18,100,101],{},"На современных версиях macOS (Catalina и выше) ZSH уже предустановлен. Однако на более старых системах (например, Mojave или Sierra) его может не быть. В этом случае установите ZSH с помощью Homebrew:",[66,103,105],{"className":68,"code":104,"language":70,"meta":71,"style":71},"brew install zsh\n",[73,106,107],{"__ignoreMap":71},[76,108,109,112,116],{"class":78,"line":79},[76,110,111],{"class":82},"brew",[76,113,115],{"class":114},"sZZnC"," install",[76,117,118],{"class":114}," zsh\n",[18,120,121],{},"После установки настройте ZSH как оболочку по умолчанию:",[66,123,125],{"className":68,"code":124,"language":70,"meta":71,"style":71},"chsh -s /bin/zsh\n",[73,126,127],{"__ignoreMap":71},[76,128,129,132,135],{"class":78,"line":79},[76,130,131],{"class":82},"chsh",[76,133,134],{"class":86}," -s",[76,136,137],{"class":114}," /bin/zsh\n",[18,139,140],{},"Введите пароль администратора при запросе. Затем перезапустите терминал, чтобы изменения вступили в силу.",[142,143,144],"blockquote",{},[18,145,146,147,150,151,158],{},"💡 ",[38,148,149],{},"Совет",": Если Homebrew не установлен, вы можете установить ZSH, скачав исходный код с ",[152,153,157],"a",{"href":154,"rel":155},"https://www.zsh.org/",[156],"nofollow","официального сайта"," или используя системный пакетный менеджер. Но Homebrew значительно упрощает процесс.",[13,160,162],{"id":161},"шаг-2-установка-oh-my-zsh","Шаг 2: Установка Oh My Zsh",[18,164,165],{},"Oh My Zsh – это фреймворк для управления конфигурацией ZSH, который поставляется с множеством тем и плагинов. Установка происходит с помощью одного скрипта.",[18,167,168],{},"Выполните в терминале:",[66,170,172],{"className":68,"code":171,"language":70,"meta":71,"style":71},"sh -c \"$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n",[73,173,174],{"__ignoreMap":71},[76,175,176,179,182,185,188,191],{"class":78,"line":79},[76,177,178],{"class":82},"sh",[76,180,181],{"class":86}," -c",[76,183,184],{"class":114}," \"$(",[76,186,187],{"class":82},"curl",[76,189,190],{"class":86}," -fsSL",[76,192,193],{"class":114}," https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n",[18,195,196,197,200],{},"Или, если у вас установлен ",[73,198,199],{},"wget",":",[66,202,204],{"className":68,"code":203,"language":70,"meta":71,"style":71},"sh -c \"$(wget -O- https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n",[73,205,206],{"__ignoreMap":71},[76,207,208,210,212,214,216,219],{"class":78,"line":79},[76,209,178],{"class":82},[76,211,181],{"class":86},[76,213,184],{"class":114},[76,215,199],{"class":82},[76,217,218],{"class":86}," -O-",[76,220,193],{"class":114},[18,222,223],{},"Скрипт автоматически:",[32,225,226,233,240],{},[35,227,228,229,232],{},"Клонирует репозиторий Oh My Zsh в ",[73,230,231],{},"~/.oh-my-zsh",".",[35,234,235,236,239],{},"Создает резервную копию существующего файла ",[73,237,238],{},"~/.zshrc"," (если есть) и заменяет его шаблоном.",[35,241,242],{},"Настраивает ZSH как оболочку по умолчанию, если это еще не сделано.",[18,244,245,246,249],{},"После установки терминал перезапустится автоматически, и вы увидите новое приглашение командной строки с темой по умолчанию (обычно ",[73,247,248],{},"robbyrussell",").",[142,251,252],{},[18,253,254,255,258],{},"⚠️ ",[38,256,257],{},"Важно",": Убедитесь, что у вас есть права на запись в домашний каталог. Если установка завершилась с ошибкой, проверьте соединение с интернетом и повторите попытку.",[13,260,262],{"id":261},"шаг-3-выбор-и-настройка-темы","Шаг 3: Выбор и настройка темы",[18,264,265],{},"Oh My Zsh поставляется с более чем 100 готовыми темами, которые меняют внешний вид приглашения командной строки, включая цвета, отображение текущего каталога, статус Git и другую информацию.",[18,267,268],{},"Чтобы изменить тему:",[270,271,272,293,317,358,376],"ol",{},[35,273,274,275,277,278,200,281],{},"Откройте файл конфигурации ",[73,276,238],{}," в текстовом редакторе. Например, с помощью ",[73,279,280],{},"nano",[66,282,284],{"className":68,"code":283,"language":70,"meta":71,"style":71},"nano ~/.zshrc\n",[73,285,286],{"__ignoreMap":71},[76,287,288,290],{"class":78,"line":79},[76,289,280],{"class":82},[76,291,292],{"class":114}," ~/.zshrc\n",[35,294,295,296,299,300],{},"Найдите строку с переменной ",[73,297,298],{},"ZSH_THEME",". По умолчанию она выглядит так:",[66,301,303],{"className":68,"code":302,"language":70,"meta":71,"style":71},"ZSH_THEME=\"robbyrussell\"\n",[73,304,305],{"__ignoreMap":71},[76,306,307,310,314],{"class":78,"line":79},[76,308,298],{"class":309},"sVt8B",[76,311,313],{"class":312},"szBVR","=",[76,315,316],{"class":114},"\"robbyrussell\"\n",[35,318,319,320,200,323,337,340,341,344,345],{},"Замените значение на название желаемой темы. Например, для популярной темы ",[73,321,322],{},"agnoster",[66,324,326],{"className":68,"code":325,"language":70,"meta":71,"style":71},"ZSH_THEME=\"agnoster\"\n",[73,327,328],{"__ignoreMap":71},[76,329,330,332,334],{"class":78,"line":79},[76,331,298],{"class":309},[76,333,313],{"class":312},[76,335,336],{"class":114},"\"agnoster\"\n",[338,339],"br",{},"Список доступных тем находится в каталоге ",[73,342,343],{},"~/.oh-my-zsh/themes/",". Вы можете просмотреть их, выполнив:",[66,346,348],{"className":68,"code":347,"language":70,"meta":71,"style":71},"ls ~/.oh-my-zsh/themes/\n",[73,349,350],{"__ignoreMap":71},[76,351,352,355],{"class":78,"line":79},[76,353,354],{"class":82},"ls",[76,356,357],{"class":114}," ~/.oh-my-zsh/themes/\n",[35,359,360,361,363,364,367,368,371,372,375],{},"Сохраните файл (в ",[73,362,280],{}," нажмите ",[73,365,366],{},"Ctrl+X",", затем ",[73,369,370],{},"Y"," и ",[73,373,374],{},"Enter",") и закройте редактор.",[35,377,378,379],{},"Примените изменения, выполнив:",[66,380,382],{"className":68,"code":381,"language":70,"meta":71,"style":71},"source ~/.zshrc\n",[73,383,384],{"__ignoreMap":71},[76,385,386,389],{"class":78,"line":79},[76,387,388],{"class":86},"source",[76,390,292],{"class":114},[18,392,393,394,396],{},"Теперь приглашение командной строки должно обновиться. Некоторые темы (например, ",[73,395,322],{},") требуют специальных шрифтов, таких как Powerline, для корректного отображения символов. Если символы отображаются некорректно, установите шрифт Powerline:",[66,398,400],{"className":68,"code":399,"language":70,"meta":71,"style":71},"brew tap homebrew/cask-fonts\nbrew install --cask font-hack-nerd-font\n",[73,401,402,412],{"__ignoreMap":71},[76,403,404,406,409],{"class":78,"line":79},[76,405,111],{"class":82},[76,407,408],{"class":114}," tap",[76,410,411],{"class":114}," homebrew/cask-fonts\n",[76,413,415,417,419,422],{"class":78,"line":414},2,[76,416,111],{"class":82},[76,418,115],{"class":114},[76,420,421],{"class":86}," --cask",[76,423,424],{"class":114}," font-hack-nerd-font\n",[18,426,427],{},"Затем настройте терминал на использование этого шрифта в настройках профиля.",[429,430],"in-article-ad",{},[13,432,434],{"id":433},"шаг-4-добавление-плагинов","Шаг 4: Добавление плагинов",[18,436,437],{},"Плагины расширяют функциональность ZSH, добавляя такие возможности, как подсветка синтаксиса, предложения команд на основе истории, интеграцию с Git и многое другое.",[18,439,440],{},"Oh My Zsh включает в себя несколько встроенных плагинов. Чтобы их активировать:",[270,442,443,448,478,504],{},[35,444,445,446,232],{},"Откройте файл ",[73,447,238],{},[35,449,450,451,454,455,458,459],{},"Найдите переменную ",[73,452,453],{},"plugins",". По умолчанию она может быть пустой или содержать ",[73,456,457],{},"git",":\n",[66,460,462],{"className":68,"code":461,"language":70,"meta":71,"style":71},"plugins=(git)\n",[73,463,464],{"__ignoreMap":71},[76,465,466,468,470,473,475],{"class":78,"line":79},[76,467,453],{"class":309},[76,469,313],{"class":312},[76,471,472],{"class":309},"(",[76,474,457],{"class":114},[76,476,477],{"class":309},")\n",[35,479,480,481],{},"Добавьте нужные плагины в скобках, разделяя пробелами. Например, для включения популярных плагинов:\n",[66,482,484],{"className":68,"code":483,"language":70,"meta":71,"style":71},"plugins=(git zsh-syntax-highlighting zsh-autosuggestions)\n",[73,485,486],{"__ignoreMap":71},[76,487,488,490,492,494,496,499,502],{"class":78,"line":79},[76,489,453],{"class":309},[76,491,313],{"class":312},[76,493,472],{"class":309},[76,495,457],{"class":114},[76,497,498],{"class":114}," zsh-syntax-highlighting",[76,500,501],{"class":114}," zsh-autosuggestions",[76,503,477],{"class":309},[35,505,506,507,232],{},"Сохраните файл и выполните ",[73,508,509],{},"source ~/.zshrc",[18,511,512,513,371,516,519,520,523],{},"Обратите внимание: плагины ",[73,514,515],{},"zsh-syntax-highlighting",[73,517,518],{},"zsh-autosuggestions"," не входят в базовую установку Oh My Zsh, но легко добавляются. Если вы только что установили Oh My Zsh, эти плагины уже могут быть доступны в каталоге ",[73,521,522],{},"~/.oh-my-zsh/custom/plugins/",". Если нет, установите их вручную:",[66,525,527],{"className":68,"code":526,"language":70,"meta":71,"style":71},"git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting\ngit clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions\n",[73,528,529,562],{"__ignoreMap":71},[76,530,531,533,536,539,542,545,548,551,554,556,559],{"class":78,"line":79},[76,532,457],{"class":82},[76,534,535],{"class":114}," clone",[76,537,538],{"class":114}," https://github.com/zsh-users/zsh-syntax-highlighting.git",[76,540,541],{"class":309}," ${ZSH_CUSTOM",[76,543,544],{"class":312},":-",[76,546,547],{"class":309},"~",[76,549,550],{"class":312},"/",[76,552,553],{"class":309},".oh-my-zsh",[76,555,550],{"class":312},[76,557,558],{"class":309},"custom}",[76,560,561],{"class":114},"/plugins/zsh-syntax-highlighting\n",[76,563,564,566,568,571,573,575,577,579,581,583,585],{"class":78,"line":414},[76,565,457],{"class":82},[76,567,535],{"class":114},[76,569,570],{"class":114}," https://github.com/zsh-users/zsh-autosuggestions.git",[76,572,541],{"class":309},[76,574,544],{"class":312},[76,576,547],{"class":309},[76,578,550],{"class":312},[76,580,553],{"class":309},[76,582,550],{"class":312},[76,584,558],{"class":309},[76,586,587],{"class":114},"/plugins/zsh-autosuggestions\n",[18,589,590,591,593,594,596],{},"Затем добавьте их в список ",[73,592,453],{}," в ",[73,595,238],{},", как показано выше.",[598,599,601],"h3",{"id":600},"краткий-обзор-популярных-плагинов","Краткий обзор популярных плагинов:",[32,603,604,617,622,630,643],{},[35,605,606,608,609,612,613,616],{},[38,607,457],{},": добавляет сокращения для команд Git (например, ",[73,610,611],{},"gco"," для ",[73,614,615],{},"git checkout",") и показывает статус ветки в приглашении.",[35,618,619,621],{},[38,620,515],{},": подсвечивает команды в реальном времени, указывая на синтаксические ошибки (красный) или корректные (зеленый).",[35,623,624,626,627,249],{},[38,625,518],{},": предлагает завершение команд на основе вашей истории при наборе (серый текст, который можно принять клавишей ",[73,628,629],{},"→",[35,631,632,635,636,550,639,642],{},[38,633,634],{},"history-substring-search",": позволяет искать в истории команд по введенным символам (используйте ",[73,637,638],{},"↑",[73,640,641],{},"↓"," после набора части команды).",[35,644,645,648],{},[38,646,647],{},"web-search",": добавляет алиасы для поиска в Google, GitHub и других сервисах прямо из терминала.",[18,650,651],{},"Экспериментируйте с разными плагинами, чтобы найти оптимальный набор для ваших задач.",[13,653,655],{"id":654},"шаг-5-настройка-алиасов-и-переменных-окружения","Шаг 5: Настройка алиасов и переменных окружения",[18,657,658,659,661],{},"Вы можете добавить собственные алиасы (псевдонимы команд) и переменные окружения в файл ",[73,660,238],{}," для автоматической загрузки при запуске ZSH.",[598,663,665],{"id":664},"добавление-алиасов","Добавление алиасов",[18,667,668,669,671],{},"В конце файла ",[73,670,238],{}," добавьте блок с алиасами. Например:",[66,673,675],{"className":68,"code":674,"language":70,"meta":71,"style":71},"# Полезные алиасы\nalias ll='ls -la'\nalias la='ls -A'\nalias l='ls -CF'\nalias gs='git status'\nalias ga='git add'\nalias gc='git commit'\nalias gp='git push'\n",[73,676,677,683,696,709,722,735,748,761],{"__ignoreMap":71},[76,678,679],{"class":78,"line":79},[76,680,682],{"class":681},"sJ8bj","# Полезные алиасы\n",[76,684,685,688,691,693],{"class":78,"line":414},[76,686,687],{"class":312},"alias",[76,689,690],{"class":309}," ll",[76,692,313],{"class":312},[76,694,695],{"class":114},"'ls -la'\n",[76,697,699,701,704,706],{"class":78,"line":698},3,[76,700,687],{"class":312},[76,702,703],{"class":309}," la",[76,705,313],{"class":312},[76,707,708],{"class":114},"'ls -A'\n",[76,710,712,714,717,719],{"class":78,"line":711},4,[76,713,687],{"class":312},[76,715,716],{"class":309}," l",[76,718,313],{"class":312},[76,720,721],{"class":114},"'ls -CF'\n",[76,723,725,727,730,732],{"class":78,"line":724},5,[76,726,687],{"class":312},[76,728,729],{"class":309}," gs",[76,731,313],{"class":312},[76,733,734],{"class":114},"'git status'\n",[76,736,738,740,743,745],{"class":78,"line":737},6,[76,739,687],{"class":312},[76,741,742],{"class":309}," ga",[76,744,313],{"class":312},[76,746,747],{"class":114},"'git add'\n",[76,749,751,753,756,758],{"class":78,"line":750},7,[76,752,687],{"class":312},[76,754,755],{"class":309}," gc",[76,757,313],{"class":312},[76,759,760],{"class":114},"'git commit'\n",[76,762,764,766,769,771],{"class":78,"line":763},8,[76,765,687],{"class":312},[76,767,768],{"class":309}," gp",[76,770,313],{"class":312},[76,772,773],{"class":114},"'git push'\n",[18,775,776,777,232],{},"Эти алиасы упростят выполнение частых команд. Сохраните файл и выполните ",[73,778,509],{},[598,780,782],{"id":781},"экспорт-переменных-окружения","Экспорт переменных окружения",[18,784,785,786,789,790,793,794,797],{},"Для добавления переменных окружения, таких как ",[73,787,788],{},"EDITOR"," или ",[73,791,792],{},"PATH",", используйте команду ",[73,795,796],{},"export",". Например:",[66,799,801],{"className":68,"code":800,"language":70,"meta":71,"style":71},"export EDITOR=\"nano\"\nexport PATH=\"$HOME/bin:$PATH\"\n",[73,802,803,815],{"__ignoreMap":71},[76,804,805,807,810,812],{"class":78,"line":79},[76,806,796],{"class":312},[76,808,809],{"class":309}," EDITOR",[76,811,313],{"class":312},[76,813,814],{"class":114},"\"nano\"\n",[76,816,817,819,822,824,827,830,833,836],{"class":78,"line":414},[76,818,796],{"class":312},[76,820,821],{"class":309}," PATH",[76,823,313],{"class":312},[76,825,826],{"class":114},"\"",[76,828,829],{"class":309},"$HOME",[76,831,832],{"class":114},"/bin:",[76,834,835],{"class":309},"$PATH",[76,837,838],{"class":114},"\"\n",[18,840,841,842,844,845,848,849,232],{},"Это установит ",[73,843,280],{}," как редактор по умолчанию и добавит каталог ",[73,846,847],{},"~/bin"," в начало ",[73,850,792],{},[13,852,854],{"id":853},"шаг-6-применение-и-проверка-изменений","Шаг 6: Применение и проверка изменений",[18,856,857,858,860],{},"После внесения всех изменений в ",[73,859,238],{}," необходимо перезагрузить конфигурацию ZSH. Вы можете сделать это одним из способов:",[32,862,863,876],{},[35,864,865,866],{},"Выполнить в терминале:\n",[66,867,868],{"className":68,"code":381,"language":70,"meta":71,"style":71},[73,869,870],{"__ignoreMap":71},[76,871,872,874],{"class":78,"line":79},[76,873,388],{"class":86},[76,875,292],{"class":114},[35,877,878],{},"Или просто закрыть и снова открыть терминал (или вкладку).",[18,880,881],{},"Теперь все настройки должны быть активны.",[598,883,885],{"id":884},"проверка-результата","Проверка результата",[18,887,888],{},"Убедитесь, что ZSH работает корректно:",[270,890,891,905,911,920,933],{},[35,892,893,896,897,900,901,904],{},[38,894,895],{},"Проверьте оболочку",": выполните ",[73,898,899],{},"echo $SHELL",". Должно вернуться ",[73,902,903],{},"/bin/zsh"," или путь к ZSH.",[35,906,907,910],{},[38,908,909],{},"Проверьте тему",": если вы меняли тему, убедитесь, что приглашение командной строки отображается с новым стилем.",[35,912,913,916,917,919],{},[38,914,915],{},"Проверьте плагины",": например, если включен плагин ",[73,918,457],{},", перейдите в каталог Git-репозитория и убедитесь, что в приглашении отображается ветка.",[35,921,922,925,926,929,930,232],{},[38,923,924],{},"Проверьте алиасы",": введите ",[73,927,928],{},"ll"," и убедитесь, что выполняется ",[73,931,932],{},"ls -la",[35,934,935,938,939,941,942,945,946,948],{},[38,936,937],{},"Проверьте плагины в действии",": для ",[73,940,515],{}," наберите неправильную команду (например, ",[73,943,944],{},"ls --wrong",") – она должна подсветиться красным. Для ",[73,947,518],{}," начните набирать команду из истории – предложение должно появиться серым.",[18,950,951],{},"Если что-то не работает, перейдите к разделу \"Возможные проблемы\".",[13,953,955],{"id":954},"возможные-проблемы","Возможные проблемы",[18,957,958],{},"При настройке ZSH могут возникнуть следующие типичные проблемы:",[598,960,962],{"id":961},"ошибка-установки-oh-my-zsh","Ошибка установки Oh My Zsh",[18,964,965,968],{},[38,966,967],{},"Симптом",": Скрипт установки завершается с ошибкой, например, \"permission denied\" или \"curl not found\".",[18,970,971,200],{},[38,972,973],{},"Решение",[32,975,976,983,992],{},[35,977,978,979,982],{},"Убедитесь, что у вас есть права на запись в домашний каталог. Используйте ",[73,980,981],{},"sudo"," только если необходимо, но обычно не требуется.",[35,984,985,986,988,989,232],{},"Если ",[73,987,187],{}," не установлен, установите его через Homebrew: ",[73,990,991],{},"brew install curl",[35,993,994],{},"Проверьте интернет-соединение и повторите установку.",[598,996,998],{"id":997},"тема-не-применяется","Тема не применяется",[18,1000,1001,1003,1004,232],{},[38,1002,967],{},": Приглашение командной строки не изменилось после редактирования ",[73,1005,238],{},[18,1007,1008,200],{},[38,1009,973],{},[32,1011,1012,1022,1027,1030],{},[35,1013,1014,1015,1017,1018,1021],{},"Проверьте синтаксис файла ",[73,1016,238],{}," на ошибки. Выполните ",[73,1019,1020],{},"zsh -n ~/.zshrc"," – если вывод пустой, ошибок нет.",[35,1023,1024,1025,232],{},"Убедитесь, что название темы указано правильно и тема существует в ",[73,1026,343],{},[35,1028,1029],{},"Если тема требует специальных шрифтов (например, Powerline), установите их и настройте терминал.",[35,1031,1032,1033,232],{},"После изменений не забудьте выполнить ",[73,1034,509],{},[598,1036,1038],{"id":1037},"плагины-не-работают","Плагины не работают",[18,1040,1041,1043],{},[38,1042,967],{},": Функции плагинов, такие как подсветка синтаксиса или предложения, отсутствуют.",[18,1045,1046,200],{},[38,1047,973],{},[32,1049,1050,1058,1067,1073],{},[35,1051,1052,1053,593,1055,1057],{},"Убедитесь, что плагины перечислены в переменной ",[73,1054,453],{},[73,1056,238],{}," и разделены пробелами.",[35,1059,1060,1061,1063,1064,1066],{},"Для плагинов, не входящих в Oh My Zsh по умолчанию (например, ",[73,1062,515],{},"), проверьте, что они установлены в каталог ",[73,1065,522],{},". Если нет – клонируйте репозитории, как описано в Шаге 4.",[35,1068,1069,1070,1072],{},"Перезагрузите ZSH с помощью ",[73,1071,509],{}," или перезапустите терминал.",[35,1074,1075],{},"Проверьте, нет ли конфликтов между плагинами. Попробуйте временно убрать некоторые из списка.",[598,1077,1079],{"id":1078},"zsh-не-обновляется-после-изменений","ZSH не обновляется после изменений",[18,1081,1082,1084,1085,1087],{},[38,1083,967],{},": Вы внесли изменения в ",[73,1086,238],{},", но они не применяются.",[18,1089,1090,200],{},[38,1091,973],{},[32,1093,1094,1104,1107,1113],{},[35,1095,1096,1097,1099,1100,1103],{},"Убедитесь, что вы редактируете правильный файл. Для пользователя он находится в ",[73,1098,238],{},". Если вы используете системный ZSH, конфиг может быть в ",[73,1101,1102],{},"/etc/zshrc",", но это не рекомендуется.",[35,1105,1106],{},"Проверьте, что вы сохранили файл после редактирования.",[35,1108,1109,1110,1112],{},"Выполните ",[73,1111,509],{}," в той же сессии терминала, где вы редактировали файл.",[35,1114,1115],{},"Если проблема сохраняется, перезапустите терминал полностью.",[598,1117,1119],{"id":1118},"ошибка-command-not-found-для-oh-my-zsh-команд","Ошибка \"command not found\" для Oh My Zsh команд",[18,1121,1122,1124,1125,1128],{},[38,1123,967],{},": Команды, такие как ",[73,1126,1127],{},"omz",", не распознаются.",[18,1130,1131,200],{},[38,1132,973],{},[32,1134,1135,1141],{},[35,1136,1137,1138,1140],{},"Oh My Zsh добавляет свои функции автоматически при запуске. Убедитесь, что Oh My Zш установлен корректно (каталог ",[73,1139,231],{}," существует).",[35,1142,1143],{},"Если вы вручную переместили или удалили каталог, переустановите Oh My Zsh.",[18,1145,1146,1147,1152],{},"Для дополнительной помощи обратитесь к ",[152,1148,1151],{"href":1149,"rel":1150},"https://ohmyz.sh/",[156],"официальной документации Oh My Zsh"," или сообществу.",[18,1154,1155],{},"Это завершает настройку ZSH на macOS. Теперь у вас должна быть мощная и кастомизированная оболочка, которая ускорит вашу работу в терминале. Экспериментируйте с темами и плагинами, чтобы найти идеальный набор!",[1157,1158,1159],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}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 .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}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":71,"searchDepth":414,"depth":414,"links":1161},[1162,1163,1164,1165,1166,1167,1170,1174,1177],{"id":15,"depth":414,"text":16},{"id":26,"depth":414,"text":27},{"id":97,"depth":414,"text":98},{"id":161,"depth":414,"text":162},{"id":261,"depth":414,"text":262},{"id":433,"depth":414,"text":434,"children":1168},[1169],{"id":600,"depth":698,"text":601},{"id":654,"depth":414,"text":655,"children":1171},[1172,1173],{"id":664,"depth":698,"text":665},{"id":781,"depth":698,"text":782},{"id":853,"depth":414,"text":854,"children":1175},[1176],{"id":884,"depth":698,"text":885},{"id":954,"depth":414,"text":955,"children":1178},[1179,1180,1181,1182,1183],{"id":961,"depth":698,"text":962},{"id":997,"depth":698,"text":998},{"id":1037,"depth":698,"text":1038},{"id":1078,"depth":698,"text":1079},{"id":1118,"depth":698,"text":1119},null,"2026-02-16 10:02:17","Пошаговая инструкция по настройке ZSH на macOS. Установите Oh My Zsh, выберите тему, добавьте плагины и оптимизируйте работу в терминале. Все за 15-30 минут.","medium",false,"15-30 мин","md",[1192,1195,1198,1201],{"question":1193,"answer":1194},"Что такое ZSH и зачем он нужен?","ZSH – это современная оболочка командной строки с улучшенными функциями, такими как автодополнение, поддержка тем и плагинов, что делает работу в терминале более удобной и эффективной.",{"question":1196,"answer":1197},"Как установить ZSH на macOS, если он не предустановлен?","Используйте Homebrew: `brew install zsh`, затем настройте его как оболочку по умолчанию через `chsh -s /bin/zsh`.",{"question":1199,"answer":1200},"Как сбросить настройки ZSH к стандартным?","Удалите или переименуйте каталог `~/.oh-my-zsh` и файл `~/.zshrc`, затем перезапустите терминал. Oh My Zsh переустановится при следующем входе.",{"question":1202,"answer":1203},"Можно ли использовать ZSH без Oh My Zsh?","Да, вы можете настраивать ZSH напрямую через файл `~/.zshrc`, но Oh My Zsh значительно упрощает управление плагинами и темами.",[1205,1208,1211,1214,1217,1220],{"name":1206,"text":1207},"Проверка установки ZSH","Откройте терминал и выполните `zsh --version`, чтобы убедиться, что ZSH установлен. Если команда не найдена, установите ZSH через Homebrew или системные средства.",{"name":1209,"text":1210},"Установка Oh My Zsh","Запустите скрипт установки Oh My Zsh, который автоматически настроит конфигурационные файлы и установит базовую тему.",{"name":1212,"text":1213},"Выбор темы оформления","Отредактируйте файл `~/.zshrc`, изменив переменную `ZSH_THEME` на название желаемой темы, например, `agnoster`.",{"name":1215,"text":1216},"Добавление плагинов","В том же файле `~/.zshrc` в переменной `plugins` перечислите нужные плагины, такие как `git`, `zsh-syntax-highlighting` и `zsh-autosuggestions`.",{"name":1218,"text":1219},"Настройка алиасов и переменных","Добавьте свои команды-псевдонимы (алиасы) и экспортируйте переменные окружения в разделе `~/.zshrc` для персонализации оболочки.",{"name":1221,"text":1222},"Применение изменений","Выполните `source ~/.zshrc` в терминале или перезапустите его, чтобы все настройки вступили в силу.","PT25M",[1225,1226,1227,1228,1229,1230,1231,1232,1233,1234],"настройка zsh macos","установка oh my zsh macos","кастомизация zsh macos","темы zsh macos","плагины zsh macos","zsh конфигурация macos","bash vs zsh macos","перейти на zsh macos","исправить zsh macos","terminal zsh macos настройка","ru_RU",{},true,"/guides/macos/configure-zsh","macos",[1241,1242,1243],"/guides/macos/install-homebrew","/guides/macos/configure-iterm2","/errors/macos/zsh-syntax-error","Гайды macOS",{"title":5,"description":1186},"guides/macos/configure-zsh","Этот гайд поможет вам настроить ZSH на macOS, установить Oh My Zsh для расширения функциональности и кастомизировать оболочку под свои нужды.",[1239,83,1249,1250,1251,1252,1253],"oh-my-zsh","terminal","оболочка","настройка","command-line","guide","WNuo_ZOefLYONLPPAyyf6AYWmn_O69La-T-SdZv5Yd4",{"data":1257,"body":1258},{},{"type":1259,"children":1260},"root",[1261],{"type":1262,"tag":18,"props":1263,"children":1264},"element",{},[1265],{"type":1266,"value":1194},"text",{"data":1268,"body":1269},{},{"type":1259,"children":1270},[1271],{"type":1262,"tag":18,"props":1272,"children":1273},{},[1274,1276,1282,1284,1290],{"type":1266,"value":1275},"Используйте Homebrew: ",{"type":1262,"tag":73,"props":1277,"children":1279},{"className":1278},[],[1280],{"type":1266,"value":1281},"brew install zsh",{"type":1266,"value":1283},", затем настройте его как оболочку по умолчанию через ",{"type":1262,"tag":73,"props":1285,"children":1287},{"className":1286},[],[1288],{"type":1266,"value":1289},"chsh -s /bin/zsh",{"type":1266,"value":232},{"data":1292,"body":1293},{},{"type":1259,"children":1294},[1295],{"type":1262,"tag":18,"props":1296,"children":1297},{},[1298,1300,1305,1307,1312],{"type":1266,"value":1299},"Удалите или переименуйте каталог ",{"type":1262,"tag":73,"props":1301,"children":1303},{"className":1302},[],[1304],{"type":1266,"value":231},{"type":1266,"value":1306}," и файл ",{"type":1262,"tag":73,"props":1308,"children":1310},{"className":1309},[],[1311],{"type":1266,"value":238},{"type":1266,"value":1313},", затем перезапустите терминал. Oh My Zsh переустановится при следующем входе.",{"data":1315,"body":1316},{},{"type":1259,"children":1317},[1318],{"type":1262,"tag":18,"props":1319,"children":1320},{},[1321,1323,1328],{"type":1266,"value":1322},"Да, вы можете настраивать ZSH напрямую через файл ",{"type":1262,"tag":73,"props":1324,"children":1326},{"className":1325},[],[1327],{"type":1266,"value":238},{"type":1266,"value":1329},", но Oh My Zsh значительно упрощает управление плагинами и темами.",{"data":1331,"body":1332},{},{"type":1259,"children":1333},[1334],{"type":1262,"tag":18,"props":1335,"children":1336},{},[1337,1339,1345],{"type":1266,"value":1338},"Откройте терминал и выполните ",{"type":1262,"tag":73,"props":1340,"children":1342},{"className":1341},[],[1343],{"type":1266,"value":1344},"zsh --version",{"type":1266,"value":1346},", чтобы убедиться, что ZSH установлен. Если команда не найдена, установите ZSH через Homebrew или системные средства.",{"data":1348,"body":1349},{},{"type":1259,"children":1350},[1351],{"type":1262,"tag":18,"props":1352,"children":1353},{},[1354],{"type":1266,"value":1210},{"data":1356,"body":1357},{},{"type":1259,"children":1358},[1359],{"type":1262,"tag":18,"props":1360,"children":1361},{},[1362,1364,1369,1371,1376,1378,1383],{"type":1266,"value":1363},"Отредактируйте файл ",{"type":1262,"tag":73,"props":1365,"children":1367},{"className":1366},[],[1368],{"type":1266,"value":238},{"type":1266,"value":1370},", изменив переменную ",{"type":1262,"tag":73,"props":1372,"children":1374},{"className":1373},[],[1375],{"type":1266,"value":298},{"type":1266,"value":1377}," на название желаемой темы, например, ",{"type":1262,"tag":73,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":1266,"value":322},{"type":1266,"value":232},{"data":1385,"body":1386},{},{"type":1259,"children":1387},[1388],{"type":1262,"tag":18,"props":1389,"children":1390},{},[1391,1393,1398,1400,1405,1407,1412,1414,1419,1420,1425],{"type":1266,"value":1392},"В том же файле ",{"type":1262,"tag":73,"props":1394,"children":1396},{"className":1395},[],[1397],{"type":1266,"value":238},{"type":1266,"value":1399}," в переменной ",{"type":1262,"tag":73,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":1266,"value":453},{"type":1266,"value":1406}," перечислите нужные плагины, такие как ",{"type":1262,"tag":73,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":1266,"value":457},{"type":1266,"value":1413},", ",{"type":1262,"tag":73,"props":1415,"children":1417},{"className":1416},[],[1418],{"type":1266,"value":515},{"type":1266,"value":371},{"type":1262,"tag":73,"props":1421,"children":1423},{"className":1422},[],[1424],{"type":1266,"value":518},{"type":1266,"value":232},{"data":1427,"body":1428},{},{"type":1259,"children":1429},[1430],{"type":1262,"tag":18,"props":1431,"children":1432},{},[1433,1435,1440],{"type":1266,"value":1434},"Добавьте свои команды-псевдонимы (алиасы) и экспортируйте переменные окружения в разделе ",{"type":1262,"tag":73,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":1266,"value":238},{"type":1266,"value":1441}," для персонализации оболочки.",{"data":1443,"body":1444},{},{"type":1259,"children":1445},[1446],{"type":1262,"tag":18,"props":1447,"children":1448},{},[1449,1450,1455],{"type":1266,"value":1109},{"type":1262,"tag":73,"props":1451,"children":1453},{"className":1452},[],[1454],{"type":1266,"value":509},{"type":1266,"value":1456}," в терминале или перезапустите его, чтобы все настройки вступили в силу.",[1458,2173],{"id":1459,"title":1460,"appliesTo":1461,"author":8,"body":1466,"canonical":1184,"code":1184,"createdAt":2115,"description":2116,"difficulty":2117,"draft":1188,"estimatedTime":2118,"extension":1190,"faq":2119,"howToSteps":2132,"howToTotalTime":2148,"image":1184,"keywords":2149,"locale":1235,"meta":2158,"navigation":1237,"path":1241,"platform":1239,"related":2159,"section":1244,"seo":2163,"severity":1184,"stem":2164,"summary":2165,"tags":2166,"twitterCreator":1184,"twitterSite":1184,"type":1254,"updatedAt":2115,"__hash__":2172},"content_ru/guides/macos/install-homebrew.md","Установка Homebrew на macOS: пошаговое руководство для новичков",[1462,1463,1464,1465],"macOS Sonoma 14.x","macOS Ventura 13.x","macOS Monterey 12.x","Intel и Apple Silicon (M1/M2/M3)",{"type":10,"value":1467,"toc":2094},[1468,1472,1482,1505,1508,1512,1515,1549,1553,1557,1564,1585,1590,1621,1623,1627,1636,1640,1643,1673,1679,1683,1693,1765,1772,1774,1777,1847,1849,1859,1872,1894,1900,1915,1922,1936,1940,1948,1984,1988,1994,2014,2025,2042,2047,2082,2091],[13,1469,1471],{"id":1470},"введение-зачем-это-нужно","Введение / Зачем это нужно",[18,1473,1474,1475,1477,1478,1481],{},"Homebrew (или просто ",[73,1476,111],{},") — это менеджер пакетов для macOS, который упрощает установку, обновление и удалениеThousands open-source программ и библиотек. Вместо ручного скачивания ",[73,1479,1480],{},".dmg","-файлов, поиска зависимостей и настройки переменных среды вы используете одну команду:",[66,1483,1485],{"className":68,"code":1484,"language":70,"meta":71,"style":71},"brew install \u003Cимя_программы>\n",[73,1486,1487],{"__ignoreMap":71},[76,1488,1489,1491,1493,1496,1499,1502],{"class":78,"line":79},[76,1490,111],{"class":82},[76,1492,115],{"class":114},[76,1494,1495],{"class":312}," \u003C",[76,1497,1498],{"class":114},"имя_программ",[76,1500,1501],{"class":309},"ы",[76,1503,1504],{"class":312},">\n",[18,1506,1507],{},"Этот гайд показывает, как правильно установить Homebrew с нуля на любой современной версии macOS (от Monterey до Sonoma) на процессорах как Intel, так и Apple Silicon (M1/M2/M3).",[13,1509,1511],{"id":1510},"требования-подготовка","Требования / Подготовка",[18,1513,1514],{},"Перед началом убедитесь, что:",[270,1516,1517,1526,1546],{},[35,1518,1519,1520,1523,1524,249],{},"У вас есть учётная запись с ",[38,1521,1522],{},"правами администратора"," (возможность использовать ",[73,1525,981],{},[35,1527,1528,1529,1532,1533],{},"Установлены ",[38,1530,1531],{},"Xcode Command Line Tools",". Homebrew предложит их установить автоматически, но если хотите сделать это заранее, выполните в Терминале:\n",[66,1534,1536],{"className":68,"code":1535,"language":70,"meta":71,"style":71},"xcode-select --install\n",[73,1537,1538],{"__ignoreMap":71},[76,1539,1540,1543],{"class":78,"line":79},[76,1541,1542],{"class":82},"xcode-select",[76,1544,1545],{"class":86}," --install\n",[35,1547,1548],{},"У вас стабильное подключение к интернету.",[13,1550,1552],{"id":1551},"пошаговая-инструкция","Пошаговая инструкция",[598,1554,1556],{"id":1555},"шаг-1-запустите-официальный-скрипт-установки","Шаг 1: Запустите официальный скрипт установки",[18,1558,1559,1560,1563],{},"Единственный и самый важный шаг. ",[38,1561,1562],{},"Никогда не устанавливайте Homebrew из ненадёжных источников."," Используйте только официальный скрипт:",[66,1565,1567],{"className":68,"code":1566,"language":70,"meta":71,"style":71},"/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n",[73,1568,1569],{"__ignoreMap":71},[76,1570,1571,1574,1576,1578,1580,1582],{"class":78,"line":79},[76,1572,1573],{"class":82},"/bin/bash",[76,1575,181],{"class":86},[76,1577,184],{"class":114},[76,1579,187],{"class":82},[76,1581,190],{"class":86},[76,1583,1584],{"class":114}," https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n",[18,1586,1587],{},[38,1588,1589],{},"Что делает команда:",[32,1591,1592,1609,1615],{},[35,1593,1594,1597,1598,1601,1602,1605,1606,249],{},[73,1595,1596],{},"curl -fsSL ..."," — скачивает скрипт установки с GitHub, следуя редиректам (",[73,1599,1600],{},"-L","), не показывая прогресс (",[73,1603,1604],{},"-s","), и failing silently на ошибках (",[73,1607,1608],{},"-f",[35,1610,1611,1614],{},[73,1612,1613],{},"$(...)"," — выполняет скачанный скрипт в текущей оболочке.",[35,1616,1617,1620],{},[73,1618,1619],{},"/bin/bash -c"," — явно запускает скрипт в bash, даже если ваш терминал по умолчанию использует zsh (актуально для macOS Catalina+).",[429,1622],{},[598,1624,1626],{"id":1625},"шаг-2-введите-пароль-администратора","Шаг 2: Введите пароль администратора",[18,1628,1629,1630,1633,1634,232],{},"После запуска скрипта система запросит ваш пароль. Вводите его ",[38,1631,1632],{},"всё с маленькой буквы",", символы не будут отображаться (даже звёздочки) — это особенность безопасности macOS. Просто введите пароль и нажмите ",[73,1635,374],{},[598,1637,1639],{"id":1638},"шаг-3-дождитесь-завершения-установки","Шаг 3: Дождитесь завершения установки",[18,1641,1642],{},"Скрипт выполнит следующие действия:",[270,1644,1645,1648,1659,1662],{},[35,1646,1647],{},"Проверит наличие Xcode Command Line Tools и установит их при необходимости (может потребоваться отдельно нажать «Установить» в всплывающем окне).",[35,1649,1650,1651,1654,1655,1658],{},"Создадит нужные директории (",[73,1652,1653],{},"/usr/local"," для Intel или ",[73,1656,1657],{},"/opt/homebrew"," для Apple Silicon).",[35,1660,1661],{},"Скачает и распакует последнюю стабильную версию Homebrew.",[35,1663,1664,1665,1668,1669,1672],{},"Настроит переменные среды в вашем профиле оболочки (",[73,1666,1667],{},".zprofile"," для zsh, ",[73,1670,1671],{},".bash_profile"," для bash).",[18,1674,1675,1678],{},[38,1676,1677],{},"Не прерывайте процесс!"," На это может уйти до 10 минут, особенно при первом запуске Xcode Tools.",[598,1680,1682],{"id":1681},"шаг-4-активируйте-homebrew-в-текущем-сеансе","Шаг 4: Активируйте Homebrew в текущем сеансе",[18,1684,1685,1686,1688,1689,1692],{},"После завершения установки скрипт выведет инструкции. Чтобы команда ",[73,1687,111],{}," стала доступна ",[38,1690,1691],{},"сразу в текущем открытом окне Терминала",", выполните:",[32,1694,1695,1732],{},[35,1696,1697,1700],{},[38,1698,1699],{},"Для macOS на Apple Silicon (M1/M2/M3):",[66,1701,1703],{"className":68,"code":1702,"language":70,"meta":71,"style":71},"echo 'eval \"$(/opt/homebrew/bin/brew shellenv)\"' >> ~/.zprofile\neval \"$(/opt/homebrew/bin/brew shellenv)\"\n",[73,1704,1705,1719],{"__ignoreMap":71},[76,1706,1707,1710,1713,1716],{"class":78,"line":79},[76,1708,1709],{"class":86},"echo",[76,1711,1712],{"class":114}," 'eval \"$(/opt/homebrew/bin/brew shellenv)\"'",[76,1714,1715],{"class":312}," >>",[76,1717,1718],{"class":114}," ~/.zprofile\n",[76,1720,1721,1724,1726,1729],{"class":78,"line":414},[76,1722,1723],{"class":86},"eval",[76,1725,184],{"class":114},[76,1727,1728],{"class":82},"/opt/homebrew/bin/brew",[76,1730,1731],{"class":114}," shellenv)\"\n",[35,1733,1734,1737],{},[38,1735,1736],{},"Для macOS на Intel:",[66,1738,1740],{"className":68,"code":1739,"language":70,"meta":71,"style":71},"echo 'eval \"$(/usr/local/bin/brew shellenv)\"' >> ~/.bash_profile\neval \"$(/usr/local/bin/brew shellenv)\"\n",[73,1741,1742,1754],{"__ignoreMap":71},[76,1743,1744,1746,1749,1751],{"class":78,"line":79},[76,1745,1709],{"class":86},[76,1747,1748],{"class":114}," 'eval \"$(/usr/local/bin/brew shellenv)\"'",[76,1750,1715],{"class":312},[76,1752,1753],{"class":114}," ~/.bash_profile\n",[76,1755,1756,1758,1760,1763],{"class":78,"line":414},[76,1757,1723],{"class":86},[76,1759,184],{"class":114},[76,1761,1762],{"class":82},"/usr/local/bin/brew",[76,1764,1731],{"class":114},[18,1766,1767,1768,1771],{},"Либо просто ",[38,1769,1770],{},"закройте и снова откройте Терминал"," — изменения вступят в силу автоматически.",[13,1773,885],{"id":884},[18,1775,1776],{},"Убедитесь, что установка прошла успешно:",[270,1778,1779,1799,1821],{},[35,1780,1781,1782,1793,1795,1796,232],{},"Проверьте версию:",[66,1783,1785],{"className":68,"code":1784,"language":70,"meta":71,"style":71},"brew --version\n",[73,1786,1787],{"__ignoreMap":71},[76,1788,1789,1791],{"class":78,"line":79},[76,1790,111],{"class":82},[76,1792,87],{"class":86},[338,1794],{},"Вывод должен быть примерно таким: ",[73,1797,1798],{},"Homebrew 4.x.x",[35,1800,1801,1802,1814,1816,1817,1820],{},"Запустите диагностику:",[66,1803,1805],{"className":68,"code":1804,"language":70,"meta":71,"style":71},"brew doctor\n",[73,1806,1807],{"__ignoreMap":71},[76,1808,1809,1811],{"class":78,"line":79},[76,1810,111],{"class":82},[76,1812,1813],{"class":114}," doctor\n",[338,1815],{},"Идеальный результат: ",[73,1818,1819],{},"Your system is ready to brew."," Если есть предупреждения — следуйте их советам.",[35,1822,1823,1824,1826,1827,1841,1843,1844,232],{},"Попробуйте установить простую утилиту (например, ",[73,1825,199],{},"):",[66,1828,1830],{"className":68,"code":1829,"language":70,"meta":71,"style":71},"brew install wget\n",[73,1831,1832],{"__ignoreMap":71},[76,1833,1834,1836,1838],{"class":78,"line":79},[76,1835,111],{"class":82},[76,1837,115],{"class":114},[76,1839,1840],{"class":114}," wget\n",[338,1842],{},"После успешной установки выполните ",[73,1845,1846],{},"wget --version",[13,1848,955],{"id":954},[598,1850,1852,1853,789,1856],{"id":1851},"ошибка-permission-denied-или-operation-not-permitted","Ошибка: ",[73,1854,1855],{},"Permission denied",[73,1857,1858],{},"Operation not permitted",[18,1860,1861,1864,1865,1868,1869,1871],{},[38,1862,1863],{},"Причина:"," Терминал запущен без прав администратора, или скрипт не может записать в целевую директорию.\n",[38,1866,1867],{},"Решение:"," Убедитесь, что вы вводили пароль при запросе. Если проблема осталась, попробуйте запустить скрипт с ",[73,1870,981],{}," (хотя официальная инструкция этого не требует):",[66,1873,1875],{"className":68,"code":1874,"language":70,"meta":71,"style":71},"sudo /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n",[73,1876,1877],{"__ignoreMap":71},[76,1878,1879,1881,1884,1886,1888,1890,1892],{"class":78,"line":79},[76,1880,981],{"class":82},[76,1882,1883],{"class":114}," /bin/bash",[76,1885,181],{"class":86},[76,1887,184],{"class":114},[76,1889,187],{"class":82},[76,1891,190],{"class":86},[76,1893,1584],{"class":114},[598,1895,1852,1897],{"id":1896},"ошибка-command-line-tools-already-installed",[73,1898,1899],{},"Command Line Tools already installed",[18,1901,1902,1904,1905,1907,1908,1911,1912,232],{},[38,1903,1863],{}," Xcode Command Tools уже присутствуют, но их путь не настроен.\n",[38,1906,1867],{}," Выполните ",[73,1909,1910],{},"sudo xcode-select --reset"," или укажите путь явно: ",[73,1913,1914],{},"sudo xcode-select -s /Library/Developer/CommandLineTools",[598,1916,1852,1918,1921],{"id":1917},"ошибка-brew-command-not-found-после-установки",[73,1919,1920],{},"brew: command not found"," после установки",[18,1923,1924,1926,1927,1929,1930,1932,1933,1935],{},[38,1925,1863],{}," Переменная ",[73,1928,792],{}," не обновлена в текущем сеансе.\n",[38,1931,1867],{}," Следуйте шагу 4 выше (активация через ",[73,1934,1723],{},") или перезапустите Терминал.",[598,1937,1939],{"id":1938},"медленная-установка-или-обрывы","Медленная установка или обрывы",[18,1941,1942,1944,1945,1947],{},[38,1943,1863],{}," Проблемы с сетью или GitHub.\n",[38,1946,1867],{}," Установите Homebrew через国内的镜像（如清华源）или используйте VPN. Для смены репозитория выполните:",[66,1949,1951],{"className":68,"code":1950,"language":70,"meta":71,"style":71},"cd \"$(brew --repo)/Library/Taps/homebrew/homebrew-core\"\ngit remote set-url origin https://mirror.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git\n",[73,1952,1953,1968],{"__ignoreMap":71},[76,1954,1955,1958,1960,1962,1965],{"class":78,"line":79},[76,1956,1957],{"class":86},"cd",[76,1959,184],{"class":114},[76,1961,111],{"class":82},[76,1963,1964],{"class":86}," --repo",[76,1966,1967],{"class":114},")/Library/Taps/homebrew/homebrew-core\"\n",[76,1969,1970,1972,1975,1978,1981],{"class":78,"line":414},[76,1971,457],{"class":82},[76,1973,1974],{"class":114}," remote",[76,1976,1977],{"class":114}," set-url",[76,1979,1980],{"class":114}," origin",[76,1982,1983],{"class":114}," https://mirror.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git\n",[13,1985,1987],{"id":1986},"часто-задаваемые-вопросы-faq","Часто задаваемые вопросы (FAQ)",[18,1989,1990,1993],{},[38,1991,1992],{},"Можно ли удалить Homebrew?","\nДа. Для полного удаления выполните официальный скрипт удаления:",[66,1995,1997],{"className":68,"code":1996,"language":70,"meta":71,"style":71},"/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)\"\n",[73,1998,1999],{"__ignoreMap":71},[76,2000,2001,2003,2005,2007,2009,2011],{"class":78,"line":79},[76,2002,1573],{"class":82},[76,2004,181],{"class":86},[76,2006,184],{"class":114},[76,2008,187],{"class":82},[76,2010,190],{"class":86},[76,2012,2013],{"class":114}," https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)\"\n",[18,2015,2016,2017,2020,2021,550,2023,232],{},"Затем вручную удалите остаточные файлы: ",[73,2018,2019],{},"rm -rf ~/.brew"," (если был) и строки из ",[73,2022,1667],{},[73,2024,1671],{},[18,2026,2027,2030,2031,2034,2035,2038,2039,232],{},[38,2028,2029],{},"Как обновлять Homebrew и установленные пакеты?","\nОбновляйте Homebrew: ",[73,2032,2033],{},"brew update",". Обновляйте все пакеты: ",[73,2036,2037],{},"brew upgrade",". Для очистки старых версий: ",[73,2040,2041],{},"brew cleanup",[18,2043,2044],{},[38,2045,2046],{},"Что такое Formulae и Casks?",[32,2048,2049,2060],{},[35,2050,2051,2054,2055,1413,2058,249],{},[38,2052,2053],{},"Formulae"," — пакеты с консольными утилитами и библиотеками (например, ",[73,2056,2057],{},"python",[73,2059,457],{},[35,2061,2062,2065,2066,550,2068,2071,2072,1413,2075,2078,2079,232],{},[38,2063,2064],{},"Casks"," — пакеты с GUI-приложениями в формате ",[73,2067,1480],{},[73,2069,2070],{},".pkg"," (например, ",[73,2073,2074],{},"firefox",[73,2076,2077],{},"visual-studio-code","). Устанавливаются командой ",[73,2080,2081],{},"brew install --cask \u003Cимя>",[18,2083,2084,2087,2090],{},[38,2085,2086],{},"Можно ли использовать Homebrew вместе с MacPorts или Fink?",[38,2088,2089],{},"Нет."," Эти менеджеры пакетов конфликтуют, так как используют одинаковые пути. Выберите один. Homebrew — самый популярный и рекомендуемый для большинства пользователей.",[1157,2092,2093],{},"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 pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}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}",{"title":71,"searchDepth":414,"depth":414,"links":2095},[2096,2097,2098,2104,2105,2114],{"id":1470,"depth":414,"text":1471},{"id":1510,"depth":414,"text":1511},{"id":1551,"depth":414,"text":1552,"children":2099},[2100,2101,2102,2103],{"id":1555,"depth":698,"text":1556},{"id":1625,"depth":698,"text":1626},{"id":1638,"depth":698,"text":1639},{"id":1681,"depth":698,"text":1682},{"id":884,"depth":414,"text":885},{"id":954,"depth":414,"text":955,"children":2106},[2107,2109,2111,2113],{"id":1851,"depth":698,"text":2108},"Ошибка: Permission denied или Operation not permitted",{"id":1896,"depth":698,"text":2110},"Ошибка: Command Line Tools already installed",{"id":1917,"depth":698,"text":2112},"Ошибка: brew: command not found после установки",{"id":1938,"depth":698,"text":1939},{"id":1986,"depth":414,"text":1987},"2026-02-15 16:29:32","Полная инструкция по установке Homebrew — официального менеджера пакетов для macOS. Установите за 5 минут и начните работать с thousand open-source утилит.","easy","5-10 мин",[2120,2123,2126,2129],{"question":2121,"answer":2122},"Можно ли установить Homebrew без прав администратора?","Нет, для установки Homebrew требуются права администратора (sudo), так как он устанавливает файлы в системные директории (`/usr/local` или `/opt/homebrew`).",{"question":2124,"answer":2125},"Что делать, если установка зависла на 'Downloading and installing Xcode Command Line Tools'?","Это нормальный процесс, который может занять 10-20 минут в зависимости от скорости интернета. Не прерывайте его. Если зависло надолго (>30 мин), закройте терминал и попробуйте снова.",{"question":2127,"answer":2128},"Homebrew конфликтует с системными программами. Как быть?","Homebrew по дизайну изолирован от системных файлов. Конфликты обычно возникают, если вы вручную меняли переменные `PATH` или ставили софт в те же директории. Проверьте порядок путей в `echo $PATH`.",{"question":2130,"answer":2131},"Можно ли установить Homebrew на внешний диск?","Технически возможно, но крайне не рекомендуется. Многие формулы (пакеты) предполагают установку в стандартные пути. Используйте стандартную установку для стабильности.",[2133,2136,2139,2142,2145],{"name":2134,"text":2135},"Откройте Терминал","Найдите приложение «Терминал» через Spotlight (Cmd+Space → введите «Терминал») или в папке «Утилиты».",{"name":2137,"text":2138},"Запустите официальный скрипт установки","Скопируйте и выполните в Терминале команду ниже. Она скачает и запустит автоматический скрипт установки от разработчиков Homebrew.",{"name":2140,"text":2141},"Введите пароль администратора","При появлении запроса введите пароль от вашей учётной записи macOS (символы не отображаются — это нормально) и нажмите Enter.",{"name":2143,"text":2144},"Дождитесь завершения","Процесс установки займёт 2-5 минут. Вы увидите сообщение «Installation successful!».",{"name":2146,"text":2147},"Проверьте установку","Выполните `brew doctor` для диагностики и `brew --version` чтобы увидеть версию.","PT10M",[2150,2151,2152,2153,2154,2155,2156,2157],"установка homebrew","homebrew macos","как установить brew","менеджер пакетов macos","brew install","установить homebrew на mac","homebrew ошибка установки","command line tools macos",{},[2160,2161,2162],"/guides/macos/install-xcode-command-line-tools","/guides/macos/update-homebrew","/guides/macos/use-homebrew",{"title":1460,"description":2116},"guides/macos/install-homebrew","Это руководство поможет вам за несколько минут установить Homebrew — незаменимый менеджер пакетов для macOS. Вы сможете легко устанавливать, обновлять и управлять thousand open-source программ и библиотек через простую команду `brew`.",[1239,2167,2168,1250,111,2169,2170,2171],"homebrew","包管理器","cli","разработка","devops","pwaZTzDbmYiZNtiHnNHwJRUenCEEXxwQgnz7quu_voE",{"id":2174,"title":2175,"appliesTo":2176,"author":8,"body":2179,"canonical":1184,"code":2768,"createdAt":2769,"description":2770,"difficulty":2117,"draft":1188,"estimatedTime":2118,"extension":1190,"faq":2771,"howToSteps":2784,"howToTotalTime":2148,"image":1184,"keywords":2800,"locale":1235,"meta":2811,"navigation":1237,"path":1243,"platform":1239,"related":2812,"section":2816,"seo":2817,"severity":1187,"stem":2818,"summary":2819,"tags":2820,"twitterCreator":1184,"twitterSite":1184,"type":2828,"updatedAt":2769,"__hash__":2829},"content_ru/errors/macos/zsh-syntax-error.md","Ошибка синтаксиса Zsh на macOS: как найти и исправить",[2177,2178],"macOS 10.15+","Zsh 5.0+",{"type":10,"value":2180,"toc":2758},[2181,2185,2188,2195,2198,2204,2207,2211,2295,2299,2302,2379,2382,2384,2388,2393,2491,2495,2498,2546,2550,2553,2609,2613,2624,2681,2685,2755],[13,2182,2184],{"id":2183},"что-означает-ошибка-syntax-error","Что означает ошибка syntax error",[18,2186,2187],{},"Ошибка синтаксиса (syntax error) в Zsh — это сообщение от интерпретатора, который не может понять команду или строку в конфигурационном файле. Полный текст ошибки обычно выглядит так:",[66,2189,2193],{"className":2190,"code":2192,"language":1266},[2191],"language-text","zsh: syntax error near unexpected token `...'\n",[73,2194,2192],{"__ignoreMap":71},[18,2196,2197],{},"или",[66,2199,2202],{"className":2200,"code":2201,"language":1266},[2191],"zsh: parse error near `...'\n",[73,2203,2201],{"__ignoreMap":71},[18,2205,2206],{},"Zsh указывает на конкретный символ (токен), который вызвал проблему, и часто номер строки, если ошибка в файле. Такая ошибка возникает при запуске терминала, выполнении скрипта или вводе команды вручную.",[13,2208,2210],{"id":2209},"причины-возникновения","Причины возникновения",[270,2212,2213,2219,2231,2262,2275,2285],{},[35,2214,2215,2218],{},[38,2216,2217],{},"Опечатки в команде или конфигурационном файле"," — например, пропущенный символ или лишний пробел.",[35,2220,2221,2224,2225,789,2227,2230],{},[38,2222,2223],{},"Неправильное использование кавычек"," — несбалансированные кавычки (",[73,2226,826],{},[73,2228,2229],{},"'",") или их отсутствие там, где требуется.",[35,2232,2233,2236,2237,1413,2240,1413,2243,1413,2246,1413,2249,1413,2252,1413,2254,2257,2258,2261],{},[38,2234,2235],{},"Специальные символы без экранирования"," — символы like ",[73,2238,2239],{},"$",[73,2241,2242],{},"*",[73,2244,2245],{},"?",[73,2247,2248],{},"[",[73,2250,2251],{},"]",[73,2253,472],{},[73,2255,2256],{},")"," могут менять смысл команды, если их не экранировать обратным слешем (",[73,2259,2260],{},"\\",") или не заключить в кавычки.",[35,2263,2264,2267,2268,2271,2272,249],{},[38,2265,2266],{},"Неполные конструкции"," — незакрытые скобки, кавычки или блоки кода (например, ",[73,2269,2270],{},"if ... then"," без ",[73,2273,2274],{},"fi",[35,2276,2277,2280,2281,2284],{},[38,2278,2279],{},"Конфликт синтаксиса с Bash"," — если вы переносите команды или настройки из Bash в Zsh, некоторые конструкции (например, ",[73,2282,2283],{},"[[ ... ]]"," или арифметические операции) могут отличаться.",[35,2286,2287,2290,2291,2294],{},[38,2288,2289],{},"Повреждённый конфигурационный файл"," — например, ",[73,2292,2293],{},".zshrc"," был изменён некорректно или содержит остатки от других программ.",[13,2296,2298],{"id":2297},"способ-1-проверьте-команду-или-скрипт","Способ 1: Проверьте команду или скрипт",[18,2300,2301],{},"Если ошибка появляется при выполнении конкретной команды или скрипта, внимательно проверьте её синтаксис.",[270,2303,2304,2307,2337,2373],{},[35,2305,2306],{},"Скопируйте команду, которая вызывает ошибку.",[35,2308,2309,2310],{},"Проверьте, все ли кавычки сбалансированы. Например:\n",[66,2311,2313],{"className":68,"code":2312,"language":70,"meta":71,"style":71},"# Неправильно:\necho \"Привет\n# Правильно:\necho \"Привет\"\n",[73,2314,2315,2320,2327,2332],{"__ignoreMap":71},[76,2316,2317],{"class":78,"line":79},[76,2318,2319],{"class":681},"# Неправильно:\n",[76,2321,2322,2324],{"class":78,"line":414},[76,2323,1709],{"class":86},[76,2325,2326],{"class":114}," \"Привет\n",[76,2328,2329],{"class":78,"line":698},[76,2330,2331],{"class":114},"# Правильно:\n",[76,2333,2334],{"class":78,"line":711},[76,2335,2336],{"class":114},"echo \"Привет\"\n",[35,2338,2339,2340],{},"Убедитесь, что специальные символы экранированы, если они должны восприниматься буквально:\n",[66,2341,2343],{"className":68,"code":2342,"language":70,"meta":71,"style":71},"# Неправильно (звёздочка раскроется в имена файлов):\necho *.txt\n# Правильно:\necho \\*.txt\n",[73,2344,2345,2350,2360,2364],{"__ignoreMap":71},[76,2346,2347],{"class":78,"line":79},[76,2348,2349],{"class":681},"# Неправильно (звёздочка раскроется в имена файлов):\n",[76,2351,2352,2354,2357],{"class":78,"line":414},[76,2353,1709],{"class":86},[76,2355,2356],{"class":86}," *",[76,2358,2359],{"class":114},".txt\n",[76,2361,2362],{"class":78,"line":698},[76,2363,2331],{"class":681},[76,2365,2366,2368,2371],{"class":78,"line":711},[76,2367,1709],{"class":86},[76,2369,2370],{"class":86}," \\*",[76,2372,2359],{"class":114},[35,2374,2375,2376,2378],{},"Если команда длинная, разбейте её на части или используйте обратную косую черту (",[73,2377,2260],{},") для переноса строки.",[18,2380,2381],{},"После исправления выполните команду снова.",[429,2383],{},[13,2385,2387],{"id":2386},"способ-2-проверьте-конфигурационные-файлы-zsh","Способ 2: Проверьте конфигурационные файлы Zsh",[18,2389,2390,2391,249],{},"Если ошибка возникает при запуске нового окна терминала, проблема, скорее всего, в одном из конфигурационных файлов Zsh (например, ",[73,2392,238],{},[270,2394,2395,2404,2420,2429,2463,2477],{},[35,2396,2397,2398],{},"Посмотрите на полное сообщение об ошибке. Обычно оно указывает файл и номер строки:\n",[66,2399,2402],{"className":2400,"code":2401,"language":1266},[2191],"/Users/username/.zshrc:15: syntax error near unexpected token `;'\n",[73,2403,2401],{"__ignoreMap":71},[35,2405,2406,2407,458,2409,2419],{},"Откройте указанный файл в редакторе. Для быстрого редактирования используйте ",[73,2408,280],{},[66,2410,2411],{"className":68,"code":283,"language":70,"meta":71,"style":71},[73,2412,2413],{"__ignoreMap":71},[76,2414,2415,2417],{"class":78,"line":79},[76,2416,280],{"class":82},[76,2418,292],{"class":114},"\nЕсли ошибка в другом файле, укажите его путь.",[35,2421,2422,2423,363,2425,2428],{},"Перейдите к строке с ошибкой (в ",[73,2424,280],{},[73,2426,2427],{},"Ctrl + _",", затем введите номер строки).",[35,2430,2431,2432],{},"Проверьте синтаксис в этой строке и окружающих. Частые проблемы:\n",[32,2433,2434,2447,2450,2456],{},[35,2435,2436,2437,2440,2441,789,2444,232],{},"Отсутствие ",[73,2438,2439],{},"then"," после ",[73,2442,2443],{},"if",[73,2445,2446],{},"elif",[35,2448,2449],{},"Незакрытые кавычки или скобки.",[35,2451,2452,2453,249],{},"Лишние точки с запятой (",[73,2454,2455],{},";",[35,2457,2458,2459,2462],{},"Использование команд Bash вместо Zsh (например, ",[73,2460,2461],{},"echo $BASH_VERSION"," может быть пустым в Zsh).",[35,2464,2465,2466,593,2469,367,2471,2473,2474,249],{},"Исправьте ошибку, сохраните файл (",[73,2467,2468],{},"Ctrl + O",[73,2470,280],{},[73,2472,374],{},") и закройте редактор (",[73,2475,2476],{},"Ctrl + X",[35,2478,2479,2480,2490],{},"Примените изменения без перезапуска терминала:\n",[66,2481,2482],{"className":68,"code":381,"language":70,"meta":71,"style":71},[73,2483,2484],{"__ignoreMap":71},[76,2485,2486,2488],{"class":78,"line":79},[76,2487,388],{"class":86},[76,2489,292],{"class":114},"\nЕсли ошибка остаётся, повторите поиск в других строках.",[13,2492,2494],{"id":2493},"способ-3-временно-отключить-конфигурационные-файлы","Способ 3: Временно отключить конфигурационные файлы",[18,2496,2497],{},"Если не можете определить, в каком файле ошибка, запустите Zsh без загрузки конфигурации. Это поможет понять, связана ли проблема с настройками оболочки.",[270,2499,2500,2519,2533,2543],{},[35,2501,2502,2503,2515,2516,2518],{},"Запустите чистый сеанс Zsh:\n",[66,2504,2506],{"className":68,"code":2505,"language":70,"meta":71,"style":71},"zsh -f\n",[73,2507,2508],{"__ignoreMap":71},[76,2509,2510,2512],{"class":78,"line":79},[76,2511,83],{"class":82},[76,2513,2514],{"class":86}," -f\n","\nФлаг ",[73,2517,1608],{}," отключает чтение конфигурационных файлов.",[35,2520,2521,2522,1413,2524,1413,2527,789,2530,232],{},"Если в этом режиме ошибка не появляется, значит, проблема в одном из файлов ",[73,2523,238],{},[73,2525,2526],{},"~/.zprofile",[73,2528,2529],{},"~/.zlogin",[73,2531,2532],{},"~/.zshenv",[35,2534,2535,2536,2539,2540,2542],{},"Чтобы найти проблемный файл, последовательно переименовывайте их (например, добавьте ",[73,2537,2538],{},".backup"," к имени) и запускайте новый терминал или ",[73,2541,388],{}," оставшегося файла. Как только ошибка исчезнет, вы нашли виновника.",[35,2544,2545],{},"После локализации файла проверьте его синтаксис, как описано в Способе 2.",[13,2547,2549],{"id":2548},"способ-4-сбросить-конфигурацию-zsh","Способ 4: Сбросить конфигурацию Zsh",[18,2551,2552],{},"Если не удаётся найти ошибку вручную, проще всего временно сбросить конфигурацию к стандартной.",[270,2554,2555,2574,2596,2602],{},[35,2556,2557,2558],{},"Переименуйте основной конфигурационный файл:\n",[66,2559,2561],{"className":68,"code":2560,"language":70,"meta":71,"style":71},"mv ~/.zshrc ~/.zshrc.backup\n",[73,2562,2563],{"__ignoreMap":71},[76,2564,2565,2568,2571],{"class":78,"line":79},[76,2566,2567],{"class":82},"mv",[76,2569,2570],{"class":114}," ~/.zshrc",[76,2572,2573],{"class":114}," ~/.zshrc.backup\n",[35,2575,2576,2577,458,2579],{},"Создайте новый минимальный ",[73,2578,238],{},[66,2580,2582],{"className":68,"code":2581,"language":70,"meta":71,"style":71},"echo '# Минимальная конфигурация Zsh' > ~/.zshrc\n",[73,2583,2584],{"__ignoreMap":71},[76,2585,2586,2588,2591,2594],{"class":78,"line":79},[76,2587,1709],{"class":86},[76,2589,2590],{"class":114}," '# Минимальная конфигурация Zsh'",[76,2592,2593],{"class":312}," >",[76,2595,292],{"class":114},[35,2597,2598,2599,2601],{},"Перезапустите терминал или выполните ",[73,2600,509],{},". Ошибка должна исчезнуть.",[35,2603,2604,2605,2608],{},"Теперь вы можете постепенно переносить настройки из старого файла (",[73,2606,2607],{},"~/.zshrc.backup",") в новый, добавляя их по одной и проверяя после каждого добавления, не появилась ли ошибка. Так вы найдётся проблемную строку.",[13,2610,2612],{"id":2611},"способ-5-проверьте-скрипты-запускаемые-из-zshrc","Способ 5: Проверьте скрипты, запускаемые из .zshrc",[18,2614,2615,2616,2618,2619,2621,2622,232],{},"Иногда в ",[73,2617,238],{}," вызываются внешние скрипты (например, через ",[73,2620,388],{}," или прямое выполнение). Ошибка может быть в них, а не в самом ",[73,2623,238],{},[270,2625,2626,2654,2675],{},[35,2627,2628,2629,2631,2632,2644,2645],{},"Откройте ",[73,2630,238],{}," и найдите строки, которые запускают другие файлы:\n",[66,2633,2635],{"className":68,"code":2634,"language":70,"meta":71,"style":71},"source /path/to/script.sh\n",[73,2636,2637],{"__ignoreMap":71},[76,2638,2639,2641],{"class":78,"line":79},[76,2640,388],{"class":86},[76,2642,2643],{"class":114}," /path/to/script.sh\n","\nили\n",[66,2646,2648],{"className":68,"code":2647,"language":70,"meta":71,"style":71},"/path/to/script.sh\n",[73,2649,2650],{"__ignoreMap":71},[76,2651,2652],{"class":78,"line":79},[76,2653,2647],{"class":82},[35,2655,2656,2657,2515,2671,2674],{},"Проверьте указанные скрипты на синтаксические ошибки. Для этого можно запустить Zsh в режиме проверки синтаксиса:\n",[66,2658,2660],{"className":68,"code":2659,"language":70,"meta":71,"style":71},"zsh -n /path/to/script.sh\n",[73,2661,2662],{"__ignoreMap":71},[76,2663,2664,2666,2669],{"class":78,"line":79},[76,2665,83],{"class":82},[76,2667,2668],{"class":86}," -n",[76,2670,2643],{"class":114},[73,2672,2673],{},"-n"," не выполняет скрипт, а только проверяет синтаксис.",[35,2676,2677,2678,2680],{},"Исправьте ошибки в скриптах или временно закомментируйте их вызов в ",[73,2679,238],{},", чтобы убедиться, что проблема именно там.",[13,2682,2684],{"id":2683},"профилактика","Профилактика",[32,2686,2687,2698,2708,2720,2734],{},[35,2688,2689,2692,2693,789,2695,2697],{},[38,2690,2691],{},"Всегда проверяйте синтаксис после редактирования конфигурационных файлов",". Используйте ",[73,2694,509],{},[73,2696,1020],{},", чтобы обнаружить ошибки до перезапуска терминала.",[35,2699,2700,2703,2704,2707],{},[38,2701,2702],{},"Используйте редактор с подсветкой синтаксиса"," (например, VS Code, Sublime Text или ",[73,2705,2706],{},"vim"," с настройками), чтобы видеть незакрытые кавычки или скобки.",[35,2709,2710,2713,2714,2716,2717,249],{},[38,2711,2712],{},"Экранируйте специальные символы",", если они должны восприниматься буквально. В Zsh, как и в Bash, для этого используется обратный слеш (",[73,2715,2260],{},") или одинарные кавычки (",[73,2718,2719],{},"'...'",[35,2721,2722,2725,2726,2729,2730,2733],{},[38,2723,2724],{},"Не копируйте команды Bash в Zsh без проверки",". Хотя Zsh в режиме совместимости (",[73,2727,2728],{},"emulate sh",") может работать с Bash-синтаксисом, лучше адаптировать команды под Zsh или явно указывать оболочку (например, ",[73,2731,2732],{},"#!/usr/bin/env bash"," в скриптах).",[35,2735,2736,2739,2740],{},[38,2737,2738],{},"Резервное копирование конфигурационных файлов"," перед крупными изменениями. Это позволит быстро откатиться в случае ошибки:\n",[66,2741,2743],{"className":68,"code":2742,"language":70,"meta":71,"style":71},"cp ~/.zshrc ~/.zshrc.bak\n",[73,2744,2745],{"__ignoreMap":71},[76,2746,2747,2750,2752],{"class":78,"line":79},[76,2748,2749],{"class":82},"cp",[76,2751,2570],{"class":114},[76,2753,2754],{"class":114}," ~/.zshrc.bak\n",[1157,2756,2757],{},"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":71,"searchDepth":414,"depth":414,"links":2759},[2760,2761,2762,2763,2764,2765,2766,2767],{"id":2183,"depth":414,"text":2184},{"id":2209,"depth":414,"text":2210},{"id":2297,"depth":414,"text":2298},{"id":2386,"depth":414,"text":2387},{"id":2493,"depth":414,"text":2494},{"id":2548,"depth":414,"text":2549},{"id":2611,"depth":414,"text":2612},{"id":2683,"depth":414,"text":2684},"syntax error","2026-02-16 20:33:52","Подробное руководство по устранению ошибки синтаксиса в Zsh на macOS. Причины, пошаговые решения и профилактика. Исправьте проблему за 5-10 минут.",[2772,2775,2778,2781],{"question":2773,"answer":2774},"Что такое ошибка синтаксиса в Zsh и почему она возникает?","Ошибка синтаксиса в Zsh возникает, когда оболочка не может распознать последовательность символов как корректную команду. Частые причины: опечатки, отсутствие кавычек, неправильное использование специальных символов или конфликт синтаксиса с Bash.",{"question":2776,"answer":2777},"Как быстро найти строку с ошибкой в конфигурационном файле Zsh?","Zsh обычно указывает номер строки и имя файла, где возникла ошибка. Если это файл .zshrc, откройте его в редакторе (например, `nano ~/.zshrc`) и перейдите к указанной строке.",{"question":2779,"answer":2780},"Можно ли отключить Zsh и вернуться к Bash, чтобы избежать ошибок?","Да, вы можете изменить оболочку по умолчанию командой `chsh -s /bin/bash`, но это не решит проблему, если ошибка в самом скрипте или конфигурации. Лучше исправлять ошибку в Zsh.",{"question":2782,"answer":2783},"Почему ошибка появляется только при запуске нового окна терминала?","Потому что Zsh автоматически выполняет файлы конфигурации (например, ~/.zshrc) при каждом запуске. Ошибка в этих файлах приведёт к сбою при открытии нового терминала.",[2785,2788,2791,2794,2797],{"name":2786,"text":2787},"Определите источник ошибки","Внимательно прочитайте сообщение об ошибке. Оно обычно содержит тип ошибки (syntax error или parse error), имя файла и номер строки, где проблема возникла.",{"name":2789,"text":2790},"Откройте проблемный файл","Используйте редактор (например, `nano` или `vim`), чтобы открыть указанный файл. Чаще всего это конфигурационный файл `~/.zshrc`.",{"name":2792,"text":2793},"Исправьте синтаксис","Найдите строку с ошибкой и исправьте синтаксис: проверьте кавычки, скобки, специальные символы. Убедитесь, что команды совместимы с Zsh.",{"name":2795,"text":2796},"Проверьте исправление","Сохраните файл и выполните `source ~/.zshrc` (или перезапустите терминал), чтобы применить изменения. Ошибка должна исчезнуть.",{"name":2798,"text":2799},"Если ошибка не в .zshrc","Ошибка может быть в другом файле (например, в скрипте, который вы запускаете). Проверьте путь, указанный в ошибке, и откройте соответствующий файл.",[2801,2802,2803,2804,2805,2806,2807,2808,2809,2810],"ошибка синтаксиса zsh","zsh syntax error","как исправить ошибку синтаксиса в zsh","zsh: syntax error near unexpected token","parse error zsh","ошибка в .zshrc","zsh unexpected token","исправить zsh на мак","macos zsh ошибка","синтаксическая ошибка оболочки",{},[2813,2814,2815],"/errors/macos/zsh-command-not-found","/guides/macos/zsh-configuration","/errors/macos/zsh-permission-denied","Ошибки macOS",{"title":2175,"description":2770},"errors/macos/zsh-syntax-error","Статья объясняет, что вызывает ошибку синтаксиса в Zsh на macOS, и предлагает несколько проверенных способов её устранения — от проверки конфигурационных файлов до сброса оболочки.",[2821,2822,2823,1251,2824,2825,2826,2827],"ошибки macOS","Zsh","терминал","синтаксис","macOS","command line","zsh-error","error","cmhNmHOzZBzmm6zBMakt5Ne-9zsa1tjXxYMoSGRmgH8"]