Python könyvtárak telepítése – pip használata Windows, Linux és macOS alatt
Bevezető
Pythonban nagyon gyakran használunk külső könyvtárakat és csomagokat, például a requests, pandas, matplotlib vagy más modulokat. Ezekkel rengeteg kész funkciót kapunk, így nem kell mindent nekünk megírni az alapoktól.
A Python csomagok telepítésére leggyakrabban a pip csomagkezelőt használjuk. Segítségével néhány paranccsal telepíthetünk új könyvtárakat, frissíthetjük vagy eltávolíthatjuk őket, valamint elmenthetjük egy projekt teljes csomaglistáját is.
Ebben az útmutatóban lépésről lépésre megmutatom, hogyan használhatod a pip parancsot Windows, Linux és macOS alatt, hogyan ellenőrizheted a telepített csomagokat, hogyan dolgozhatsz requirements.txt fájllal, és hogyan kerülheted el a leggyakoribb hibákat.
Mi az a Python könyvtár és csomag?
A Python egyik legnagyobb előnye, hogy rengeteg kész könyvtár és csomag érhető el hozzá. Ezek olyan előre elkészített kódgyűjtemények, amelyek bizonyos feladatok megoldását egyszerűbbé teszik. Például a requests csomag segítségével HTTP-kéréseket küldhetünk, a pandas adatok kezelésére és elemzésére használható, a matplotlib pedig diagramok és grafikonok készítésében segít. Ahelyett tehát, hogy minden funkciót nekünk kellene az alapoktól megírnunk, telepíthetünk egy megfelelő csomagot, majd felhasználhatjuk annak kész eszközeit a saját programunkban.
Könyvtár, csomag vagy modul?
A három kifejezést a gyakorlatban sokszor lazán használjuk, de nem teljesen ugyanazt jelentik. A modul általában egy Python-fájl, amely kódot tartalmaz. A csomag több modul rendszerezett gyűjteménye lehet, míg a könyvtár tágabb fogalom: olyan kódgyűjtemény, amelyet valamilyen feladat megoldására használunk.
Kezdőként elég azt megjegyezned, hogy amikor pip segítségével telepítesz valamit, általában egy Python-csomagot telepítesz.
Mi az a pip, és mire használjuk?
A pip a Python egyik leggyakrabban használt csomagkezelő eszköze. Segítségével külső Python-csomagokat telepíthetünk, frissíthetünk és eltávolíthatunk a projektünkből. A pip általában a Python telepítésével együtt kerül fel a számítógépre, ezért külön telepítésre sok esetben nincs szükség. A csomagokat jellemzően a Python Package Indexből, vagyis a PyPI adatbázisából tölti le.
Példa:
pip install requests
Ez a parancs letölti és telepíti a requests csomagot az aktuális Python-környezetbe. Ha virtuális környezetet használsz, akkor a csomag csak az adott projekthez tartozó környezetbe kerül. Ezért érdemes komolyabb projekteknél mindig külön virtuális környezetben dolgozni.
Mielőtt azonban csomagot telepítenél, érdemes ellenőrizni, hogy a pip megfelelően elérhető-e a rendszereden.
Hogyan ellenőrizheted, hogy a pip telepítve van?
Mielőtt Python-csomagokat telepítenél, érdemes ellenőrizni, hogy a pip elérhető-e a rendszereden. Windows alatt nyisd meg a Parancssort vagy a PowerShellt, Linux és macOS alatt pedig a Terminált, majd futtasd:
pip --version
Ha a parancs működik, megjelenik a telepített pip verziója és az is, hogy melyik Python-környezethez tartozik.
Például valami ilyesmit láthatsz:
pip 25.x from .../site-packages/pip (python 3.x)
Ha a pip parancs nem működik, próbáld meg a Pythonhoz kötve futtatni.
Windows alatt:
python -m pip --version
Linux/macOS alatt gyakran:
python3 -m pip --version
Ez a forma azért hasznos, mert egyértelműen ahhoz a Python-verzióhoz futtatja a pip-et, amelyiket a python vagy python3 parancs használja.
Python könyvtár telepítése Windows alatt
Windows alatt Python-csomagokat legegyszerűbben a Parancssorból, PowerShellből vagy Windows Terminalból telepíthetsz. Például a requests csomag telepítéséhez futtasd:
pip install requests
Ha biztosra szeretnél menni, hogy a pip a megfelelő Python-verzióhoz tartozik, használhatod ezt a formát is:
python -m pip install requests
Sikeres telepítés után a csomag használható lesz az aktuális Python-környezetben.
Például:
import requests
Több csomag telepítése egyszerre
Egyszerre több Python-csomagot is telepíthetsz:
pip install requests pandas matplotlib
Ha virtuális környezetet használsz, telepítés előtt érdemes ellenőrizni, hogy az aktív-e. Így a csomagok nem globálisan, hanem csak az adott projekthez kerülnek telepítésre.
Python könyvtár telepítése Linux és macOS alatt
Linux és macOS rendszeren a Python-csomagokat a Terminálból telepítheted. Mivel ezeken a rendszereken gyakran a python3 parancs hivatkozik a Python 3 telepítésre, sok esetben érdemes ehhez kötni a pip használatát is.
Példa a requests csomag telepítésére:
python3 -m pip install requests
pip3 install requests
Több csomagot egyszerre is telepíthetsz:
python3 -m pip install requests pandas matplotlib
Sikeres telepítés után a csomagok az aktuális Python-környezetben lesznek elérhetők. Ha virtuális környezetet használsz, előbb aktiváld azt, majd futtasd a telepítési parancsot. Így a csomagok csak az adott projekthez tartozó környezetbe kerülnek.
Linuxon érdemes kerülni a rendszer Python-környezetének felesleges módosítását. Projektekhez biztonságosabb külön virtuális környezetet használni.
pip vagy python -m pip – melyiket érdemes használni?
Mindkét forma ugyanarra szolgál: Python-csomagok telepítésére és kezelésére. A különbség főleg abban van, hogyan választja ki a rendszer a használni kívánt Python-verziót.
Például:
pip install requests
és:
python -m pip install requests
A sima pip parancs kényelmesebb, de több Python-verzió vagy több környezet esetén előfordulhat, hogy nem ahhoz a Pythonhoz tartozik, amelyikkel éppen dolgozol. A python -m pip forma ezzel szemben egyértelműen ahhoz a Python interpreterhez futtatja a pip-et, amelyet a python parancs használ.
Linux/macOS esetén:
python3 -m pip install requests
Ha bizonytalan vagy abban, hogy a megfelelő pip-et használod-e, a python -m pip vagy python3 -m pip forma általában biztonságosabb választás.
Telepített Python-csomagok listázása – pip list
Ha szeretnéd megnézni, milyen Python-csomagok vannak telepítve az aktuális környezetben, használd a pip list parancsot.
pip list
A parancs megjeleníti a telepített csomagok nevét és verzióját.
Például:
Package Version
------------ -------
matplotlib 3.x.x
pandas 2.x.x
requests 2.x.x
Ha több Python-verzió vagy virtuális környezet van a gépeden, érdemes itt is az adott interpreterhez kötni a parancsot:
Windows:
python -m pip list
python3 -m pip list
Ez különösen hasznos hibakeresésnél, mert gyorsan ellenőrizheted, hogy egy adott csomag valóban telepítve van-e abba a Python-környezetbe, amelyet a projekted használ.
Egy Python-csomag adatainak lekérése – pip show
Ha egy konkrét Python-csomagról szeretnél részletesebb információt kapni, használd a pip show parancsot.
Például:
pip show requests
A parancs többek között megmutatja a csomag nevét, verzióját, telepítési helyét, leírását és függőségeit.
Például ilyen adatokat láthatsz:
Name: requests
Version: 2.x.x
Location: ...
Requires: ...
Ez különösen akkor hasznos, ha ellenőrizni szeretnéd, hogy pontosan melyik verzió van telepítve, vagy hogy a csomag melyik Python-környezethez tartozik.
Ha több Python-verzió van a gépen, használhatod így is:
Windows:
python -m pip show requests
Linux/macOS:
python3 -m pip show requests
Python-csomag frissítése pip segítségével
A már telepített Python-csomagokat időnként érdemes frissíteni, különösen akkor, ha hibajavítások, új funkciók vagy biztonsági frissítések érkeztek hozzájuk.
Egy csomag frissítése:
pip install --upgrade requests
Ugyanez az interpreterhez kötött formában:
Windows:
python -m pip install --upgrade requests
Linux/macOS:
python3 -m pip install --upgrade requests
A –upgrade kapcsoló azt jelzi a pip számára, hogy a már telepített csomagból keresse meg és telepítse a frissebb elérhető verziót.
Újabb verzió ellenőrzése:
A pip meg tudja mutatni azokat a csomagokat is, amelyekből újabb verzió érhető el:
pip list --outdated
Ezután eldöntheted, mely csomagokat szeretnéd frissíteni.
Python-csomag eltávolítása pip segítségével
pip uninstall requests
A pip ezután megerősítést kér az eltávolításhoz. Ha jóváhagyod, a csomag törlődik az aktuális környezetből.
Ha biztosan a megfelelő Pythonhoz tartozó pip-et szeretnéd használni:
Windows:
python -m pip uninstall requests
Linux/macOS:
python3 -m pip uninstall requests
Több csomag eltávolítását is megadhatod egyetlen paranccsal:
pip uninstall requests pandas matplotlib
Ha virtuális környezetben dolgozol, az eltávolítás csak az adott projekt környezetét érinti, a többi Python-projektedet nem.
Csomagok mentése requirements.txt fájlba
Egy Python-projekt gyakran több külső csomagot is használ. Ha szeretnéd később ugyanazt a környezetet újra létrehozni, vagy a projektet másik gépen futtatni, érdemes a telepített csomagokat egy requirements.txt fájlba menteni.
Ehhez futtasd:
pip freeze > requirements.txt
A parancs létrehoz egy requirements.txt fájlt az aktuális mappában, amely tartalmazza a telepített csomagokat és azok verzióit.
Például:
requests==2.x.x
pandas==2.x.x
matplotlib==3.x.x
Csomagok telepítése requirements.txt fájlból
Ha később ugyanazokat a csomagokat szeretnéd telepíteni egy új gépen vagy új virtuális környezetben, használd ezt a parancsot:
pip install -r requirements.txt
Interpreterhez kötve:
Windows:
python -m pip install -r requirements.txt
Linux/macOS:
python3 -m pip install -r requirements.txt
Ez az egyik legegyszerűbb módja annak, hogy egy Python-projekt függőségeit reprodukálhatóan kezeld. Különösen hasznos akkor, ha virtuális környezetben dolgozol vagy a projektet GitHubon osztod meg.
Python-csomagok telepítése virtuális környezetbe
Komolyabb Python-projektnél érdemes a csomagokat nem globálisan, hanem egy külön virtuális környezetbe telepíteni. Így minden projekt a saját csomagjait és verzióit használhatja, és kisebb az esélye annak, hogy a különböző projektek függőségei összeakadnak.
Először hozd létre és aktiváld a virtuális környezetet, majd telepítsd a szükséges csomagokat a szokásos pip paranccsal.
Példa:
pip install requests pandas matplotlib
Ha a virtuális környezet aktív, a telepített csomagok automatikusan ebbe a környezetbe kerülnek, nem a rendszer globális Python-telepítésébe.
Bővebben ebben a cikkben olvashatsz róla:
Python virtuális környezet létrehozása – venv Windows, Linux és macOS alatt >>
Ha még nem használtál virtuális környezetet, a fenti útmutatóban lépésről lépésre megtalálod a venv létrehozását, aktiválását, a requirements.txt használatát és a leggyakoribb hibák megoldását.
Python-csomagok kezelése PyCharmban
A PyCharm grafikus felületen is lehetőséget ad Python-csomagok telepítésére és kezelésére, ezért nem mindig szükséges terminálparancsokat használnod. Fontos azonban, hogy először ellenőrizd, melyik Python interpreter tartozik a projekthez. Ha a projekt virtuális környezetet használ, a PyCharmnak is ezt kell használnia.
Lépések:
- Nyisd meg a projektet a PyCharmban.
- Menj a Settings / Preferences → Project → Python Interpreter részhez.
- Ellenőrizd, hogy a megfelelő interpreter van kiválasztva.
- A csomaglistában keresd meg a telepíteni kívánt csomagot.
- Válaszd az Install lehetőséget.
Telepítés után a csomag megjelenik az adott interpreterhez tartozó csomagok között. Ha például a requests csomagot egy .venv környezetbe telepítetted terminálból, de a PyCharm egy másik Python interpretert használ, akkor előfordulhat, hogy az IDE nem találja a csomagot.
Hibakeresésnél ezért mindig érdemes összevetni, hogy a terminál és a PyCharm ugyanazt a Python-környezetet használja-e.
Gyakori hibák pip használatakor
1. A pip parancs nem található
Ha a rendszer azt írja, hogy a pip parancs nem található, próbáld meg a Pythonhoz kötve futtatni:
Windows:
python -m pip --version
Linux/macOS:
python3 -m pip --version
Ha ez sem működik, akkor előfordulhat, hogy a pip nincs megfelelően telepítve, vagy a Python telepítése nincs rendesen beállítva.
2. A csomag telepítve van, mégsem importálható
lyenkor gyakran az a probléma, hogy nem ugyanazt a Python-környezetet használod telepítéskor és futtatáskor.
Ellenőrzés:
Windows:
where python
where pip
Linux/macOS:
which python
which pip
Az útvonalaknak ugyanahhoz a Python-környezethez kell tartozniuk.
3. Rossz Python-verzióhoz telepíted a csomagot
Ha több Python-verzió is telepítve van a gépen, a sima pip parancs könnyen máshoz tartozhat, mint amit a projekt használ.
Ilyenkor inkább:
python -m pip install csomagnev
vagy:
python3 -m pip install csomagnev
4. Jogosultsági hiba jelenik meg
Rendszerszintű Python-környezetben előfordulhat, hogy nincs jogosultságod csomagokat telepíteni. Projektekhez általában jobb megoldás külön virtuális környezetet használni, mint rendszer-szintű telepítést erőltetni.
5. Linuxon a rendszer nem engedi a globális telepítést
Újabb Linux-rendszereken előfordulhat, hogy a rendszer védi a saját Python-környezetét, és nem engedi a globális pip install használatát. Ilyenkor szintén a virtuális környezet használata a javasolt megoldás.
6. Verzióütközés történik két csomag között
Előfordulhat, hogy két csomag különböző verziójú függőséget igényel. Ilyenkor a pip figyelmeztetést vagy hibát adhat. Erre is a projektenként külön virtuális környezet az egyik legjobb megoldás.
7. A PyCharm nem látja a terminálból telepített csomagot
Ellenőrizd, hogy a PyCharm ugyanazt a Python interpretert használja-e, mint amelyikhez a terminálból telepítetted a csomagot.
A legtöbb pip-probléma mögött valójában az áll, hogy több Python-verzió vagy több különböző környezet van a gépen. Ha bizonytalan vagy, mindig ellenőrizd, melyik Pythonhoz tartozik a pip, és lehetőleg virtuális környezetben dolgozz.
Mészáros Csaba
Alapító · Python Project
„Pythonban gondolkodni – lépésről lépésre.”
Most már tudod, hogyan kezeld a Python-csomagokat
Ha végigmentél ezen az útmutatón, már tudod, hogyan telepíts Python-könyvtárakat pip segítségével, hogyan ellenőrizd és frissítsd a csomagokat, hogyan használd a requirements.txt fájlt, és miért érdemes virtuális környezetben dolgozni.
Ha szeretnéd:
- lépésről lépésre megtanulni az alapokat,
- gyakorlati feladatokon keresztül fejlődni,
- és eljutni az első saját projektjeidig,
akkor innen érdemes továbbmenned.