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