Python-környezetek létrehozása és kezelése a Visual Studióban

A Python-környezetek olyan környezetek, amelyekben Python-kódot futtat, és globális, virtuális és conda környezeteket is tartalmaz. A környezet egy értelmezőből, egy kódtárból (általában a Python Standard Könyvtárból) és a telepített csomagok készletéből áll. Ezek az összetevők együttesen határozzák meg az érvényes nyelvi szerkezeteket és szintaxist, az elérhető operációsrendszer-funkciókat és a használható csomagokat.

A Windows Visual Studióban a Jelen cikkben ismertetett Python-környezetek ablak használatával kezelheti a környezeteket, és kiválaszthat egyet alapértelmezettként az új projektekhez.

A környezetek egyéb aspektusairól az alábbi cikkekben tájékozódhat:

• Egy adott projekt esetében az alapértelmezett helyett választhat egy adott környezetet .

• A Virtuális környezetek Python-projektekhez való létrehozásáról és használatáról további információt a Virtuális környezetek használata című témakörben talál.

• Ha csomagokat szeretne telepíteni egy környezetben, tekintse meg a Csomagok lap hivatkozását.

• Egy másik Python-értelmező telepítéséhez lásd: Python-értelmezők telepítése. Általánosságban elmondható, hogy ha letölt és futtat egy telepítőt egy fővonalbeli Python-disztribúcióhoz, a Visual Studio észleli, hogy az új telepítés és a környezet megjelenik a Python-környezetek ablakban, és kiválasztható projektekhez.

Megjegyzés:

A mappakéntmegnyíló Python-kód környezeteit a Fájl >megnyitása>mappa kiválasztásával kezelheti. A Python eszköztár lehetővé teszi, hogy váltson az összes észlelt környezet között, és új környezetet is adjon hozzá. A környezeti adatokat a munkaterület .vs mappájában található PythonSettings.json fájl tárolja.

Előfeltételek

• Telepített Python-számítási feladat

Ha még nem ismerkedik a Pythonnal a Visual Studióban, az általános háttérért tekintse meg az alábbi cikkeket:

• Python-támogatás Windowson a Visual Studióban
• Python-támogatás telepítése a Visual Studióban

A Python-környezetek ablak

A Visual Studio által ismert környezetek a Python-környezetek ablakban jelennek meg. Az ablak megnyitásához használja az alábbi módszerek egyikét:

• Válassza azEgyéb Windows>Python-környezetek>.
• Kattintson a jobb gombbal egy projekt Python-környezetek csomópontjára a Megoldáskezelőben , és válassza az Összes Python-környezet megtekintése lehetőséget.

A Python-környezetek ablak a Megoldáskezelő mellett jelenik meg a Visual Studióban:

A Visual Studio a beállításjegyzék használatával (a PEP 514 után) keresi a telepített globális környezeteket, valamint a virtuális környezeteket és a Conda-környezeteket. Ha nem látja a várt környezetet a listában, tekintse meg a meglévő környezet manuális azonosítását.

Amikor kiválaszt egy környezetet a listában, a Visual Studio különböző tulajdonságokat és parancsokat jelenít meg az adott környezethez a Python-környezetek ablak Áttekintés lapján, például az értelmező helye. Az Áttekintés lap alján található parancsok mindegyike megnyit egy parancssort, amelyen az értelmező fut. További információ: Python Environments window tab reference – Overview.

A környezetek listájában található legördülő listával válthat különböző lapokra, például a Csomagok és az IntelliSense lapra. Ezeket a lapokat a Python-környezetek ablaklapjának hivatkozása is ismerteti.

A környezet kiválasztása nem változtatja meg a projektekhez való viszonyát. A listában félkövér színben megjelenő alapértelmezett környezet az, amelyet a Visual Studio minden új projekthez használ. Ha egy másik környezetet szeretne használni új projektekkel, használja a Make this the default environment for new projects parancsot. A projekt kontextusában mindig kiválaszthat egy adott környezetet. További információt a projekt környezetének kiválasztása című témakörben talál.

Az egyes felsorolt környezetek jobb oldalán található egy vezérlő, amely megnyitja az adott környezet interaktív ablakát.

Megjegyzés:

A Visual Studio 2017 15.5-ös és korábbi verzióiban egy másik vezérlő jelenik meg, amely frissíti az IntelliSense adatbázist az adott környezethez. Az adatbázissal kapcsolatos részletekért tekintse meg a Python-környezetek ablaklapjának hivatkozását.

Jótanács

Ha elég szélesre bontja a Python-környezetek ablakot, a környezetek teljesebb nézete jelenik meg, amellyel kényelmesebben dolgozhat.

Megjegyzés:

Bár a Visual Studio tiszteletben tartja a rendszerwebhely-csomagok lehetőséget, nem biztosít módot a Visual Studióban való módosításra.

Mi történik, ha nem jelennek meg környezetek?

Ha nem lát semmilyen környezetet a Python-környezetek ablakban, az azt jelenti, hogy a Visual Studio nem észlelt semmilyen Python-telepítést standard helyeken. Lehet, hogy telepítette a Visual Studio 2017-et vagy újabb verziót, de törölte a Python-számítási feladat telepítőbeállításainak összes értelmező lehetőségét. Hasonlóképpen, valószínűleg telepítette a Visual Studio 2015-öt vagy korábbi verziót, de nem telepít manuálisan értelmezőt. További információ: Python-értelmezők telepítése.

Ha tudja, hogy python-értelmező van a számítógépén, de a Visual Studio (bármely verzió) nem észlelte, használja a + Egyéni parancsot az értelmező hely manuális megadásához. További információ: Meglévő környezet manuális azonosítása.

Környezettípusok

A Visual Studio globális, virtuális és conda környezetekkel is dolgozhat.

Globális környezetek

Minden Python-telepítés saját globális környezetet tart fenn. Például Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0 stb. További információ: Python-értelmezők telepítése.

Minden környezet az adott Python-értelmezőből, a standard kódtárból és az előre telepített csomagok készletéből áll. A környezet aktiválása közben telepített egyéb csomagokat is tartalmazza. Ha egy csomagot globális környezetbe telepít, az az adott környezetet használó összes projekt számára elérhetővé válik. Ha a környezet a fájlrendszer védett területén található (például a c:\programfájlokban), akkor a csomagok telepítéséhez rendszergazdai jogosultságokra van szükség.

A globális környezetek a számítógép összes projektje számára elérhetők. A Visual Studióban alapértelmezettként egy globális környezetet választ, amelyet az összes projekthez használ, kivéve, ha kifejezetten egy másikat választ egy projekthez. További információt a projekt környezetének kiválasztása című témakörben talál.

Virtuális környezetek

A globális környezetben végzett munka egyszerű módja az első lépéseknek. Idővel a környezetek zsúfolttá válhatnak a különböző projektekhez telepített számos különböző csomaggal. A zsúfoltság megnehezítheti az alkalmazás alapos tesztelését egy ismert verziójú csomagokkal. De ez a fajta környezet az, amit elvárhat egy építőszerveren vagy webszerveren. Ütközések akkor is előfordulhatnak, ha két projekt nem kompatibilis csomagokat vagy ugyanazon csomag különböző verzióit igényli.

Ezért a fejlesztők gyakran hoznak létre virtuális környezetet egy projekthez. A virtuális környezet egy projekt almappája, amely egy adott értelmező másolatát tartalmazza. Ha aktiválja a virtuális környezetet, a telepített csomagok csak az adott környezet almappájában lesznek telepítve. Amikor Python-programot futtat a virtuális környezetben, biztos lehet abban, hogy a program csak az adott csomagokon fut.

A Visual Studio közvetlen támogatást nyújt egy projekt virtuális környezetének létrehozásához. Ha requirements.txtfájlt tartalmazó projektet nyit meg, a Visual Studio automatikusan kéri, hogy hozzon létre egy virtuális környezetet, és telepítse ezeket a függőségeket. Ugyanez a viselkedés akkor jelenik meg, ha requirements.txtfájlt tartalmazó sablonból hoz létre projektet.

Egy nyitott projekten belül bármikor létrehozhat egy új virtuális környezetet. A Megoldáskezelőben bontsa ki a projektcsomópontot, kattintson a jobb gombbal a Python-környezetekre, és válassza a Környezet hozzáadása lehetőséget. A Környezet hozzáadása területen válassza a Virtuális környezet lehetőséget. További információ: Virtuális környezet létrehozása.

A Visual Studio emellett egy parancsot is biztosít egyrequirements.txt-fájl létrehozásához egy virtuális környezetből, így könnyen újra létrehozhatja a környezetet más számítógépeken. További információ: Virtuális környezetek használata.

Conda-környezetek

Conda-környezetet az eszközzel vagy a conda Visual Studio 2017 15.7-es és újabb verziójának integrált conda-kezelésével hozhat létre. A conda környezethez Anaconda vagy Miniconda szükséges. Ezek a platformok a Visual Studio Installeren keresztül érhetők el. További információ: Python-támogatás telepítése a Visual Studióban.

1. A Python-környezetek ablakban vagy a Python eszköztáron válassza a Környezet hozzáadása lehetőséget a Környezet hozzáadása párbeszédpanel megnyitásához.

2. A Környezet hozzáadása párbeszédpanelen válassza a Conda-környezet lapot:

   

3. Konfigurálja a következő mezőket:

   szakterület	Description
   Projekt	Azonosítja azt a projektet, amelyben létre kívánja hozni a környezetet.
   Név	Megadja a nevet a conda környezetnek.
   Csomagok hozzáadása innen:	Megadja, hogyan adhat hozzá csomagokat a Conda-környezethez. - Környezeti fájl: Válassza ezt a lehetőséget, ha a függőségeit leíró environment.yml fájllal rendelkezik. Adja meg a fájl nevét, vagy tallózással (...) keresse meg a fájl helyét, és válassza ki a fájlt. - Egy vagy több Anaconda-csomagnév: Válassza ezt a lehetőséget, ha egy vagy több Python-csomagot vagy Python-verziót szeretne listázni. A csomaglista arra utasítja a Condát, hogy hozzon létre egy Python-környezetet. A Python legújabb verziójának telepítéséhez használja a python parancsot. Egy adott verzió telepítéséhez használja a parancsot python=,major>.<minor> a következő módon python=3.7: . A csomag gombbal a Python-verziókat és a gyakori csomagokat is kiválaszthatja több menüből.
   Beállítás aktuális környezetként	A környezet létrehozása után aktiválja az új környezetet a kijelölt projektben.
   Beállítás alapértelmezett környezetként új projektekhez	Automatikusan beállítja és aktiválja a conda környezetet a Visual Studióban létrehozott új projektekben. Ez a beállítás ugyanaz, mint a Python-környezetek ablak új projektjeinek alapértelmezett környezetként való használata.
   Nézet a Python-környezetek ablakban	Megadja, hogy megjelenjen-e a Python-környezetek ablak a környezet létrehozása után.

   Fontos

   Conda-környezet létrehozásakor mindenképpen adjon meg legalább egy Python-verziót vagy Python-csomagot, hogy a környezet tartalmaz-e Python-futtatókörnyezetet. Használhat environments.yml fájlt vagy a csomaglistát. Ha nem adja meg ezt a specifikációt, a Visual Studio figyelmen kívül hagyja a környezetet. A környezet nem jelenik meg sehol a Python-környezetek ablakban, nem a projekt aktuális környezeteként van beállítva, és globális környezetként nem érhető el.

   Ha a Conda-környezetet Python-verzió nélkül hozza létre, a conda info parancs segítségével megtekintheti a Conda-környezet mappáinak helyét. Ezután manuálisan eltávolíthatja a környezet almappáját arról a helyről.

4. Válassza a Create gombot.

A Conda-környezet létrehozását a Kimeneti ablakban figyelheti. A létrehozás befejezése után a kimenet megjeleníti a parancssori felület (CLI) utasításait, például conda activate env:

1. A Visual Studióban ugyanúgy aktiválhat conda környezetet a projekthez, mint bármely más környezetben. További információt a projekt környezetének kiválasztása című témakörben talál.

2. Ha további csomagokat szeretne telepíteni a környezetben, használja a Python-környezetek ablak Csomagok lapját.

Megjegyzés:

A conda környezetekkel kapcsolatos legjobb eredményekért használja a Conda 4.4.8-at vagy újabb verzióját. Ne feledje, hogy a Conda-verziók eltérnek az Anaconda-verzióktól. A Miniconda (Visual Studio 2019 és Visual Studio 2022) és az Anaconda (Visual Studio 2017) megfelelő verzióit a Visual Studio Installeren keresztül telepítheti.

Ha meg szeretné tekinteni a Conda-verziót, ahol a Conda-környezetek vannak tárolva, és egyéb információkat, futtassa a conda info parancsot egy Anaconda parancssorban (egy parancssorban, ahol az Anaconda az elérési úton van):

conda info

A Conda környezeti mappái az alábbiak szerint jelennek meg:

       envs directories : C:\Users\user\.conda\envs
                          c:\anaconda3\envs
                          C:\Users\user\AppData\Local\conda\conda\envs

Mivel a Conda-környezetek nem projekttel vannak tárolva, a globális környezetekhez hasonlóan viselkednek. Ha például új csomagot telepít egy Conda-környezetbe, az elérhetővé teszi a csomagot a környezetet használó összes projekt számára.

A Visual Studio 2017 15.6-os és korábbi verziójához használhatja a Conda-környezeteket úgy, hogy manuálisan mutat rájuk a Meglévő környezet manuális azonosítása című cikkben leírtak szerint.

A Visual Studio 2017 15.7-es és újabb verziói automatikusan észlelik a Conda-környezeteket, és megjelenítik őket a Python-környezetek ablakban a következő szakaszban leírtak szerint.

Meglévő környezet manuális azonosítása

Az alábbi lépésekkel azonosíthat egy nem megfelelő helyen telepített környezetet.

1. A Python-környezetek ablakban vagy a Python eszköztáron válassza a Környezet hozzáadása lehetőséget a Környezet hozzáadása párbeszédpanel megnyitásához.

2. A Környezet hozzáadása párbeszédpanel Meglévő környezet lapján állítsa a Környezet mezőt Egyéni< értékre>:

Az Egyéni< érték kiválasztása> után a rendszer további mezőket ad hozzá a párbeszédpanelhez.

3. Állítsa az Előtag elérési útja mezőt az értelmező elérési útjára. A mezőt úgy állíthatja be, hogy böngészéssel (...) az elérési út helyére navigál.

4. Az elérési út kiválasztása után a többi mező ki lesz töltve. Tekintse át az értékeket, és szükség szerint módosítsa. Ha elkészült, válassza a Hozzáadás lehetőséget.

A Python-környezetek ablakban bármikor áttekintheti és módosíthatja a környezet részleteit.

1. A Python-környezetek ablakban válassza ki a környezetet, majd válassza a Konfigurálás lapot.

2. A módosítások végrehajtása után válassza az Alkalmaz parancsot.

A környezetet az Eltávolítás paranccsal is eltávolíthatja. További információ: Konfigurálás lap. Ez a parancs nem érhető el automatikusan észlelt környezetekhez.

Érvénytelen környezetek javítása vagy törlése

Ha a Visual Studio megkeresi egy környezet beállításjegyzék-bejegyzéseit, de az értelmező elérési útja érvénytelen, akkor a Python-környezetek ablak a környezet nevét mutató betűtípussal jeleníti meg az alábbi képen látható módon:

A megtartani kívánt környezet kijavításához először próbálja meg használni a környezet telepítőjének javítási folyamatát. A legtöbb telepítő tartalmaz javítási lehetőséget.

A beállításjegyzék módosítása egy környezet kijavításához

Ha a Python-környezet nem rendelkezik javítási lehetőséggel, vagy érvénytelen környezetet szeretne eltávolítani, az alábbi lépésekkel közvetlenül módosíthatja a beállításjegyzéket. A Visual Studio automatikusan frissíti a Python-környezetek ablakot a beállításjegyzék módosításakor.

1. Futtassa a regedit.exe fájlt a regisztrációsadatbázis-szerkesztő megnyitásához.

2. Keresse meg a konfigurációnak megfelelő környezeti mappát:

   Python-verzió	Mappa
   64 bites verzió	HKEY_LOCAL_MACHINE\SOFTWARE\Python vagy HKEY_CURRENT_USER\Software\Python
   32 bites verzió	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python
   IronPython	IronPython

3. Bontsa ki a környezet terjesztési és verziócsomópont-struktúráját:

   Disztribúció	Node
   CPython	PythonCore><Verziócsomópont>
   Anaconda	ContinuumAnalytics><Verziócsomópont>
   IronPython	<Verziócsomópont>

4. Vizsgálja meg az InstallPath csomópont alatti értékeket:

   

   • Ha a környezet továbbra is létezik a számítógépen, módosítsa a Végrehajthatópath bejegyzés értékét a megfelelő helyre. Szükség esetén javítsa ki az (Alapértelmezett) és a WindowedExecutablePath bejegyzés értékét is.
   • Ha a környezet már nem létezik a számítógépen, és el szeretné távolítani azt a Python-környezetek ablakból, törölje az InstallPath csomópont verziószám szülőcsomópontját. Az előző képen látható egy példa erre a csomópontra. A példában ez a csomópont 3.6.

   Caution

   A HKEY_CURRENT_USER\SOFTWARE\Python kulcs érvénytelen beállításai felülírják a HKEY_LOCAL_MACHINE\SOFTWARE\Python kulcs beállításait.

Python-környezet törlése vagy eltávolítása

Python-projekt eltávolításához keresse meg a Python-környezetet a Megoldáskezelőben. Kattintson a jobb gombbal az eltávolítani kívánt Python-környezetre, és válassza az Eltávolítás lehetőséget.

Ha meg szeretné tartani a Python-környezetet, de el szeretné távolítani a projektből, válassza az Eltávolítás lehetőséget. Ha véglegesen törölni szeretné a környezetet, válassza a Törlés lehetőséget.

Kapcsolódó tartalom

• Python-értelmezők telepítése
• Python-környezet kiválasztása projekthez a Visual Studióban
• Kezelje a szükséges Python-csomagokat a requirements.txt használatával
• Python-mappák használata a Visual Studio keresési útvonalaiban
• Python-környezetek ablakreferenciája