[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/macos/configure-python-path":3,"mdc--yro6d4-key":537,"mdc-huus5d-key":556,"mdc-vksrmc-key":586,"mdc-d6nxar-key":614,"mdc-cl5epp-key":644,"mdc--ka8qp3-key":666,"mdc--q3dcyb-key":697,"mdc--waec5b-key":729,"related-/guides/macos/install-python,/guides/macos/fix-command-not-found":765},{"id":4,"title":5,"appliesTo":6,"author":9,"body":10,"canonical":472,"code":472,"createdAt":473,"description":474,"difficulty":475,"draft":476,"estimatedTime":477,"extension":478,"faq":479,"howToSteps":492,"howToTotalTime":505,"image":472,"keywords":506,"locale":517,"meta":518,"navigation":519,"path":520,"platform":521,"related":522,"section":525,"seo":526,"severity":472,"stem":527,"summary":528,"tags":529,"twitterCreator":472,"twitterSite":472,"type":535,"updatedAt":473,"__hash__":536},"content_ru/guides/macos/configure-python-path.md","Как настроить переменную PATH для Python на macOS: подробное руководство",[7,8],"macOS 10.15 (Catalina) и выше","Python 3.6 и выше","FixPedia Team",{"type":11,"value":12,"toc":454},"minimark",[13,18,35,39,42,59,63,68,71,93,96,110,116,120,130,142,153,174,180,194,201,205,220,246,260,274,277,281,284,318,321,331,337,349,352,356,362,381,390,394,398,417,421,427,433,440,444,450],[14,15,17],"h2",{"id":16},"введение-зачем-это-нужно","Введение / Зачем это нужно",[19,20,21,22,26,27,30,31,34],"p",{},"Если при попытке запустить Python в терминале macOS вы видите сообщение ",[23,24,25],"code",{},"command not found",", скорее всего, путь к интерпретатору не добавлен в переменную окружения PATH. В этом руководстве вы узнаете, как правильно настроить PATH для Python на macOS, чтобы команды ",[23,28,29],{},"python"," и ",[23,32,33],{},"python3"," работали из любого места в терминале.",[14,36,38],{"id":37},"требования-подготовка","Требования / Подготовка",[19,40,41],{},"Перед началом убедитесь, что:",[43,44,45,53,56],"ul",{},[46,47,48,49,52],"li",{},"У вас установлен Python 3.x (проверить можно командой ",[23,50,51],{},"python3 --version",").",[46,54,55],{},"Вы знакомы с базовыми командами терминала.",[46,57,58],{},"У вас есть доступ к домашней директории для редактирования конфигурационных файлов.",[14,60,62],{"id":61},"пошаговая-инструкция","Пошаговая инструкция",[64,65,67],"h3",{"id":66},"шаг-1-проверьте-текущий-path-и-расположение-python","Шаг 1: Проверьте текущий PATH и расположение Python",[19,69,70],{},"Откройте Терминал и выполните:",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes github-light github-dark","echo $PATH\n","bash","",[23,79,80],{"__ignoreMap":77},[81,82,85,89],"span",{"class":83,"line":84},"line",1,[81,86,88],{"class":87},"sj4cs","echo",[81,90,92],{"class":91},"sVt8B"," $PATH\n",[19,94,95],{},"Эта команда выведет текущий список путей, разделённых двоеточиями. Затем проверьте, где расположен исполняемый файл Python:",[72,97,99],{"className":74,"code":98,"language":76,"meta":77,"style":77},"which python3\n",[23,100,101],{"__ignoreMap":77},[81,102,103,106],{"class":83,"line":84},[81,104,105],{"class":87},"which",[81,107,109],{"class":108},"sZZnC"," python3\n",[19,111,112,113,115],{},"Если команда ",[23,114,105],{}," ничего не выводит, Python либо не установлен, либо его путь не добавлен в PATH. В таком случае сначала установите Python (например, через Homebrew или с официального сайта).",[64,117,119],{"id":118},"шаг-2-определите-оболочку-и-конфигурационный-файл","Шаг 2: Определите оболочку и конфигурационный файл",[19,121,122,123,125,126,129],{},"macOS использует разные оболочки командной строки: ",[23,124,76],{}," (до версии Catalina) или ",[23,127,128],{},"zsh"," (с Catalina и новее). Определите текущую оболочку:",[72,131,133],{"className":74,"code":132,"language":76,"meta":77,"style":77},"echo $SHELL\n",[23,134,135],{"__ignoreMap":77},[81,136,137,139],{"class":83,"line":84},[81,138,88],{"class":87},[81,140,141],{"class":91}," $SHELL\n",[19,143,144,145,148,149,152],{},"Вывод будет something like ",[23,146,147],{},"/bin/zsh"," или ",[23,150,151],{},"/bin/bash",". Соответствующие конфигурационные файлы:",[43,154,155,164],{},[46,156,157,158,160,161],{},"Для ",[23,159,128],{},": ",[23,162,163],{},"~/.zshrc",[46,165,157,166,160,168,148,171],{},[23,167,76],{},[23,169,170],{},"~/.bash_profile",[23,172,173],{},"~/.bashrc",[19,175,176,177,179],{},"Откройте нужный файл в текстовом редакторе. Например, для ",[23,178,128],{},":",[72,181,183],{"className":74,"code":182,"language":76,"meta":77,"style":77},"nano ~/.zshrc\n",[23,184,185],{"__ignoreMap":77},[81,186,187,191],{"class":83,"line":84},[81,188,190],{"class":189},"sScJk","nano",[81,192,193],{"class":108}," ~/.zshrc\n",[19,195,196,197,200],{},"Или используйте ",[23,198,199],{},"vim"," или любой другой редактор по вашему выбору.",[64,202,204],{"id":203},"шаг-3-добавьте-путь-к-python-в-переменную-path","Шаг 3: Добавьте путь к Python в переменную PATH",[19,206,207,208,211,212,215,216,219],{},"В открытом файле найдите конец файла и добавьте строку, которая добавит директорию с исполняемым файлом Python в начало PATH. Предположим, ",[23,209,210],{},"which python3"," вернул ",[23,213,214],{},"/usr/local/bin/python3",". Тогда директория — ",[23,217,218],{},"/usr/local/bin",". Добавьте:",[72,221,223],{"className":74,"code":222,"language":76,"meta":77,"style":77},"export PATH=\"/usr/local/bin:$PATH\"\n",[23,224,225],{"__ignoreMap":77},[81,226,227,231,234,237,240,243],{"class":83,"line":84},[81,228,230],{"class":229},"szBVR","export",[81,232,233],{"class":91}," PATH",[81,235,236],{"class":229},"=",[81,238,239],{"class":108},"\"/usr/local/bin:",[81,241,242],{"class":91},"$PATH",[81,244,245],{"class":108},"\"\n",[247,248,249],"blockquote",{},[19,250,251,252,256,257,259],{},"💡 ",[253,254,255],"strong",{},"Совет",": Указывайте путь именно к директории, а не к самому файлу ",[23,258,33],{},". И используйте двойные кавычки, если путь содержит пробелы (обычно нет).",[19,261,262,263,265,266,269,270,273],{},"Сохраните файл и закройте редактор. В ",[23,264,190],{}," это ",[23,267,268],{},"Ctrl+O"," (Enter для подтверждения) и ",[23,271,272],{},"Ctrl+X",".",[275,276],"in-article-ad",{},[64,278,280],{"id":279},"шаг-4-примените-изменения-и-проверьте-результат","Шаг 4: Примените изменения и проверьте результат",[19,282,283],{},"Чтобы изменения вступили в силу без перезапуска терминала, выполните:",[72,285,287],{"className":74,"code":286,"language":76,"meta":77,"style":77},"source ~/.zshrc   # для zsh\n# или\nsource ~/.bash_profile   # для bash\n",[23,288,289,301,307],{"__ignoreMap":77},[81,290,291,294,297],{"class":83,"line":84},[81,292,293],{"class":87},"source",[81,295,296],{"class":108}," ~/.zshrc",[81,298,300],{"class":299},"sJ8bj","   # для zsh\n",[81,302,304],{"class":83,"line":303},2,[81,305,306],{"class":299},"# или\n",[81,308,310,312,315],{"class":83,"line":309},3,[81,311,293],{"class":87},[81,313,314],{"class":108}," ~/.bash_profile",[81,316,317],{"class":299},"   # для bash\n",[19,319,320],{},"Если вы не уверены, какой файл редактировали, просто перезакройте и откройте Терминал заново. Затем проверьте, что Python теперь в PATH:",[72,322,323],{"className":74,"code":98,"language":76,"meta":77,"style":77},[23,324,325],{"__ignoreMap":77},[81,326,327,329],{"class":83,"line":84},[81,328,105],{"class":87},[81,330,109],{"class":108},[19,332,333,334,336],{},"Эта команда должна вывести путь, который вы добавили (например, ",[23,335,214],{},"). Также проверьте версию:",[72,338,340],{"className":74,"code":339,"language":76,"meta":77,"style":77},"python3 --version\n",[23,341,342],{"__ignoreMap":77},[81,343,344,346],{"class":83,"line":84},[81,345,33],{"class":189},[81,347,348],{"class":87}," --version\n",[19,350,351],{},"Если команды работают, настройка завершена.",[14,353,355],{"id":354},"проверка-результата","Проверка результата",[19,357,358,359,361],{},"Убедитесь, что ",[23,360,33],{}," доступен из любого каталога. Попробуйте перейти в другую директорию, например:",[72,363,365],{"className":74,"code":364,"language":76,"meta":77,"style":77},"cd ~\npython3 --version\n",[23,366,367,375],{"__ignoreMap":77},[81,368,369,372],{"class":83,"line":84},[81,370,371],{"class":87},"cd",[81,373,374],{"class":108}," ~\n",[81,376,377,379],{"class":83,"line":303},[81,378,33],{"class":189},[81,380,348],{"class":87},[19,382,383,384,386,387,273],{},"Если вы видите версию Python, значит, PATH настроен корректно. Также можно попробовать запустить Python интерактивно: ",[23,385,33],{}," и выйти с ",[23,388,389],{},"exit()",[14,391,393],{"id":392},"возможные-проблемы","Возможные проблемы",[64,395,397],{"id":396},"python-не-найден-после-настройки","Python не найден после настройки",[43,399,400,408,411],{},[46,401,402,403,405,406,273],{},"Убедитесь, что вы добавили правильный путь к директории (а не к файлу). Проверьте, что ",[23,404,210],{}," возвращает путь, который вы указали в ",[23,407,230],{},[46,409,410],{},"Убедитесь, что вы редактировали конфигурационный файл для вашей текущей оболочки.",[46,412,413,414,416],{},"После редактирования файла обязательно выполните ",[23,415,293],{}," или перезапустите терминал.",[64,418,420],{"id":419},"не-та-версия-python-запускается","Не та версия Python запускается",[19,422,423,424,273],{},"Порядок путей в PATH важен: система ищет исполняемые файлы слева направо. Если у вас несколько версий Python, убедитесь, что путь к нужной версии стоит раньше других. Можно проверить порядок: ",[23,425,426],{},"echo $PATH",[64,428,430,431],{"id":429},"ошибка-при-выполнении-source","Ошибка при выполнении ",[23,432,293],{},[19,434,435,436,439],{},"Возможно, в конфигурационном файле есть синтаксическая ошибка. Откройте файл и проверьте, что строка ",[23,437,438],{},"export PATH=\"...\""," написана верно, без лишних символов.",[64,441,443],{"id":442},"изменения-не-сохраняются-после-перезапуска","Изменения не сохраняются после перезапуска",[19,445,446,447,449],{},"Убедитесь, что вы редактировали правильный файл (например, ",[23,448,163],{}," для zsh). Если вы используете другую оболочку, изменения не применятся.",[451,452,453],"style",{},"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 .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 .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}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":77,"searchDepth":303,"depth":303,"links":455},[456,457,458,464,465],{"id":16,"depth":303,"text":17},{"id":37,"depth":303,"text":38},{"id":61,"depth":303,"text":62,"children":459},[460,461,462,463],{"id":66,"depth":309,"text":67},{"id":118,"depth":309,"text":119},{"id":203,"depth":309,"text":204},{"id":279,"depth":309,"text":280},{"id":354,"depth":303,"text":355},{"id":392,"depth":303,"text":393,"children":466},[467,468,469,471],{"id":396,"depth":309,"text":397},{"id":419,"depth":309,"text":420},{"id":429,"depth":309,"text":470},"Ошибка при выполнении source",{"id":442,"depth":309,"text":443},null,"2026-02-14 23:41:28","Пошаговая инструкция по настройке PATH для Python на macOS. Узнайте, как добавить путь к интерпретатору, чтобы команды python и python3 работали в терминале. Включает проверку и решение типичных проблем.","medium",false,"5-10 мин","md",[480,483,486,489],{"question":481,"answer":482},"Как проверить текущий PATH в macOS?","Используйте команду `echo $PATH` в терминале. Она выведет список директорий, где система ищет исполняемые файлы.",{"question":484,"answer":485},"Что делать, если Python не найден после настройки PATH?","Убедитесь, что вы добавили правильный путь к директории с `python3` (например, `/usr/local/bin`), и выполните `source ~/.zshrc` или перезапустите терминал.",{"question":487,"answer":488},"Какой конфигурационный файл редактировать: .bash_profile или .zshrc?","Зависит от вашей оболочки. Для zsh (по умолчанию в macOS Catalina и новее) — `~/.zshrc`. Для bash — `~/.bash_profile` или `~/.bashrc`.",{"question":490,"answer":491},"Почему после добавления Python в PATH команда `python` всё равно не работает?","Возможно, у вас установлен только `python3`, а не `python`. В этом случае можно создать символьную ссылку или использовать `python3` напрямую. Также проверьте порядок путей в PATH.",[493,496,499,502],{"name":494,"text":495},"Проверьте текущий PATH и расположение Python","В терминале выполните `echo $PATH` и `which python3`, чтобы увидеть текущие настройки и locate Python.",{"name":497,"text":498},"Определите оболочку и конфигурационный файл","Узнайте, какую оболочку вы используете (`echo $SHELL`), и откройте соответствующий конфигурационный файл (`~/.zshrc` для zsh, `~/.bash_profile` для bash) в редакторе.",{"name":500,"text":501},"Добавьте путь к Python в переменную PATH","В конец файла добавьте строку `export PATH=\"/путь/к/python:$PATH\"`, заменив `/путь/к/python` на директорию, содержащую исполняемый файл Python (например, `/usr/local/bin`). Сохраните файл.",{"name":503,"text":504},"Примените изменения и проверьте результат","Выполните `source ~/.zshrc` (или `source ~/.bash_profile`) или перезапустите терминал. Затем проверьте `which python3` и `python3 --version`.","PT10M",[507,508,509,510,511,512,513,514,515,516],"настроить путь python macos","добавить python в path macos","переменная path python mac","python command not found macos","как указать путь к python на mac","исправить python path mac","установка python macos path","конфигурация python mac","bash_profile python path","zshrc python path","ru_RU",{},true,"/guides/macos/configure-python-path","macos",[523,524],"/guides/macos/install-python","/guides/macos/fix-command-not-found","Гайды macOS",{"title":5,"description":474},"guides/macos/configure-python-path","Этот гайд поможет вам настроить переменную PATH в macOS для корректной работы Python из терминала. Вы научитесь находить путь к исполняемому файлу Python, редактировать конфигурационные файлы оболочки и проверять результат.",[530,531,532,533,76,128,534],"macOS","Python","PATH","terminal","environment variables","guide","EAy-kEht0xLgx3VyjE5Tl-QDv_MmgCZbj9Ag3-VeeyM",{"data":538,"body":539},{},{"type":540,"children":541},"root",[542],{"type":543,"tag":19,"props":544,"children":545},"element",{},[546,549,554],{"type":547,"value":548},"text","Используйте команду ",{"type":543,"tag":23,"props":550,"children":552},{"className":551},[],[553],{"type":547,"value":426},{"type":547,"value":555}," в терминале. Она выведет список директорий, где система ищет исполняемые файлы.",{"data":557,"body":558},{},{"type":540,"children":559},[560],{"type":543,"tag":19,"props":561,"children":562},{},[563,565,570,572,577,579,585],{"type":547,"value":564},"Убедитесь, что вы добавили правильный путь к директории с ",{"type":543,"tag":23,"props":566,"children":568},{"className":567},[],[569],{"type":547,"value":33},{"type":547,"value":571}," (например, ",{"type":543,"tag":23,"props":573,"children":575},{"className":574},[],[576],{"type":547,"value":218},{"type":547,"value":578},"), и выполните ",{"type":543,"tag":23,"props":580,"children":582},{"className":581},[],[583],{"type":547,"value":584},"source ~/.zshrc",{"type":547,"value":416},{"data":587,"body":588},{},{"type":540,"children":589},[590],{"type":543,"tag":19,"props":591,"children":592},{},[593,595,600,602,607,608,613],{"type":547,"value":594},"Зависит от вашей оболочки. Для zsh (по умолчанию в macOS Catalina и новее) — ",{"type":543,"tag":23,"props":596,"children":598},{"className":597},[],[599],{"type":547,"value":163},{"type":547,"value":601},". Для bash — ",{"type":543,"tag":23,"props":603,"children":605},{"className":604},[],[606],{"type":547,"value":170},{"type":547,"value":148},{"type":543,"tag":23,"props":609,"children":611},{"className":610},[],[612],{"type":547,"value":173},{"type":547,"value":273},{"data":615,"body":616},{},{"type":540,"children":617},[618],{"type":543,"tag":19,"props":619,"children":620},{},[621,623,628,630,635,637,642],{"type":547,"value":622},"Возможно, у вас установлен только ",{"type":543,"tag":23,"props":624,"children":626},{"className":625},[],[627],{"type":547,"value":33},{"type":547,"value":629},", а не ",{"type":543,"tag":23,"props":631,"children":633},{"className":632},[],[634],{"type":547,"value":29},{"type":547,"value":636},". В этом случае можно создать символьную ссылку или использовать ",{"type":543,"tag":23,"props":638,"children":640},{"className":639},[],[641],{"type":547,"value":33},{"type":547,"value":643}," напрямую. Также проверьте порядок путей в PATH.",{"data":645,"body":646},{},{"type":540,"children":647},[648],{"type":543,"tag":19,"props":649,"children":650},{},[651,653,658,659,664],{"type":547,"value":652},"В терминале выполните ",{"type":543,"tag":23,"props":654,"children":656},{"className":655},[],[657],{"type":547,"value":426},{"type":547,"value":30},{"type":543,"tag":23,"props":660,"children":662},{"className":661},[],[663],{"type":547,"value":210},{"type":547,"value":665},", чтобы увидеть текущие настройки и locate Python.",{"data":667,"body":668},{},{"type":540,"children":669},[670],{"type":543,"tag":19,"props":671,"children":672},{},[673,675,681,683,688,690,695],{"type":547,"value":674},"Узнайте, какую оболочку вы используете (",{"type":543,"tag":23,"props":676,"children":678},{"className":677},[],[679],{"type":547,"value":680},"echo $SHELL",{"type":547,"value":682},"), и откройте соответствующий конфигурационный файл (",{"type":543,"tag":23,"props":684,"children":686},{"className":685},[],[687],{"type":547,"value":163},{"type":547,"value":689}," для zsh, ",{"type":543,"tag":23,"props":691,"children":693},{"className":692},[],[694],{"type":547,"value":170},{"type":547,"value":696}," для bash) в редакторе.",{"data":698,"body":699},{},{"type":540,"children":700},[701],{"type":543,"tag":19,"props":702,"children":703},{},[704,706,712,714,720,722,727],{"type":547,"value":705},"В конец файла добавьте строку ",{"type":543,"tag":23,"props":707,"children":709},{"className":708},[],[710],{"type":547,"value":711},"export PATH=\"/путь/к/python:$PATH\"",{"type":547,"value":713},", заменив ",{"type":543,"tag":23,"props":715,"children":717},{"className":716},[],[718],{"type":547,"value":719},"/путь/к/python",{"type":547,"value":721}," на директорию, содержащую исполняемый файл Python (например, ",{"type":543,"tag":23,"props":723,"children":725},{"className":724},[],[726],{"type":547,"value":218},{"type":547,"value":728},"). Сохраните файл.",{"data":730,"body":731},{},{"type":540,"children":732},[733],{"type":543,"tag":19,"props":734,"children":735},{},[736,738,743,745,751,753,758,759,764],{"type":547,"value":737},"Выполните ",{"type":543,"tag":23,"props":739,"children":741},{"className":740},[],[742],{"type":547,"value":584},{"type":547,"value":744}," (или ",{"type":543,"tag":23,"props":746,"children":748},{"className":747},[],[749],{"type":547,"value":750},"source ~/.bash_profile",{"type":547,"value":752},") или перезапустите терминал. Затем проверьте ",{"type":543,"tag":23,"props":754,"children":756},{"className":755},[],[757],{"type":547,"value":210},{"type":547,"value":30},{"type":543,"tag":23,"props":760,"children":762},{"className":761},[],[763],{"type":547,"value":51},{"type":547,"value":273},[]]