Windows üzerinde Visual Studio 'da Python desteği nasıl yüklenirHow to install Python support in Visual Studio on Windows

Visual Studio için Python desteğini yüklemek için (Visual Studio için Python Araçları veya PTV olarak da bilinir), Visual Studio sürümünüz ile eşleşen bölümdeki yönergeleri izleyin:To install Python support for Visual Studio (also known as Python Tools for Visual Studio or PTVS), follow the instructions in the section that matches your version of Visual Studio:

Yükleme adımlarını tamamladıktan sonra Python desteğini hızlıca test etmek için, alti ve girerek Python etkileşimli penceresini açın + I 2+2 .To quickly test Python support after following the installation steps, open the Python Interactive window by pressing Alt+I and entering 2+2. Çıktısını görmüyorsanız 4 , adımlarınızı yeniden denetleyin.If you don't see the output of 4, recheck your steps.

İpucu

Python iş yükü; şablonları, giriş şablonu seçeneklerini bulmaya ve proje ve dosya oluşturmaya yönelik grafik kullanıcı arabirimi sağlayan yararlı Cookiecutter uzantısını içerir.The Python workload includes the helpful Cookiecutter extension that provides a graphical user interface to discover templates, input template options, and create projects and files. Ayrıntılar için bkz. Cookiecutter kullanma.For details, see Use Cookiecutter.

Not

Python desteği şu anda Mac için Visual Studio, ancak Mac ve Linux 'ta Visual Studio Code üzerinden kullanılabilir.Python support is not presently available in Visual Studio for Mac, but is available on Mac and Linux through Visual Studio Code. Sorular ve yanıtlarbölümüne bakın.See questions and answers.

Visual Studio 2019 ve Visual Studio 2017Visual Studio 2019 and Visual Studio 2017

  1. En son Visual Studio yükleyicisini indirip çalıştırın.Download and run the latest Visual Studio installer. Visual Studio zaten yüklüyse, Visual Studio Yükleyicisi çalıştırın, Değiştir seçeneğini belirleyin (bkz. Visual Studio 'yu değiştirme) ve adım 2 ' ye gidin.If you have Visual Studio installed already, run the Visual Studio Installer, select the Modify option (see Modify Visual Studio) and go to step 2.

    İpucu

    Topluluk sürümü, bireysel geliştiriciler, ders öğrenimi, akademik araştırmalar ve açık kaynak geliştirmesi içindir.The Community edition is for individual developers, classroom learning, academic research, and open source development. Diğer kullanımlar için, Visual studio 2019 Professional veya Visual Studio 2019 Enterprise'ı yükler.For other uses, install Visual Studio 2019 Professional or Visual Studio 2019 Enterprise.

  2. Yükleyici, belirli bir geliştirme alanı için ilgili seçeneklerin grupları olan iş yüklerinin bir listesini sunar.The installer presents you with a list of workloads, which are groups of related options for specific development areas. Python için Python geliştirme iş yükünü seçin.For Python, select the Python development workload.

    Visual Studio yükleyicisinde Python geliştirme iş yükü

    İsteğe bağlı: veri bilimi ile çalışıyorsanız, veri bilimi ve analitik uygulamalar iş yükünü de göz önünde bulundurun.Optional: if you're working with data science, also consider the Data science and analytical applications workload. Bu iş yükü Python, R ve F # dilleri için destek içerir.This workload includes support for the Python, R, and F# languages. Daha fazla bilgi için bkz. veri bilimi ve analitik uygulamalar iş yükü.For more information, see Data science and analytical applications workload.

    Not

    Python ve veri bilimi iş yükleri yalnızca Visual Studio 2017 sürüm 15,2 ve üzeri sürümlerle kullanılabilir.The Python and Data Science workloads are available only with Visual Studio 2017 version 15.2 and later.

    İsteğe bağlı: veri bilimi ile çalışıyorsanız, veri bilimi ve analitik uygulamalar iş yükünü de göz önünde bulundurun.Optional: if you're working with data science, also consider the Data science and analytical applications workload. Bu iş yükü Python ve F # dilleri için destek içerir.This workload includes support for the Python and F# languages. Daha fazla bilgi için bkz. veri bilimi ve analitik uygulamalar iş yükü.For more information, see Data science and analytical applications workload.

  3. Yükleyicinin sağ tarafında, istenirse ek seçenekler ' i seçin.On the right side of the installer, chose additional options if desired. Varsayılan seçenekleri kabul etmek için bu adımı atlayın.Skip this step to accept the default options.

    Visual Studio yükleyicisinde Python geliştirme seçenekleri

    Visual Studio 2019 yükleyicisinde Python geliştirme seçenekleri

    SeçenekOption AçıklamaDescription
    Python dağıtımlarıPython distributions Birlikte çalışmayı planladığınız Python 2, Python 3, Miniconda, Anaconda2 ve Anaconda3 dağıtımlarının 32-bit ve 64-bit çeşitleri gibi kullanılabilir seçeneklerin herhangi bir birleşimini seçin.Choose any combination of the available options, such as 32-bit and 64-bit variants of the Python 2, Python 3, Miniconda, Anaconda2, and Anaconda3 distributions that you plan to work with. Her biri dağıtımın yorumlayıcı, çalışma zamanı ve kitaplıklarını içerir.Each includes the distribution's interpreter, runtime, and libraries. Anaconda, özellikle de önceden yüklenmiş çok sayıda paketi içeren açık bir veri bilimi platformudur.Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (Dağıtımları eklemek veya kaldırmak için dilediğiniz zaman Visual Studio yükleyicisine dönebilirsiniz.) Note: Visual Studio yükleyicisi dışında bir dağıtım yüklediyseniz, burada eşdeğer seçeneği denetlemeniz gerekmez.(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio, mevcut Python yüklemelerini otomatik olarak algılar.Visual Studio automatically detects existing Python installations. Bkz. Python ortamları penceresi.See The Python Environments window. Ayrıca, Python 'un daha yeni bir sürümü yükleyicide gösterilenden daha fazla kullanılabiliyorsa, bu sürümü ayrı olarak yükleyebilirsiniz ve Visual Studio bunu algılar.Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Cookiecutter şablonu desteğiCookiecutter template support Şablonları, giriş şablonu seçeneklerini bulmaya ve proje ve dosya oluşturmaya yönelik Cookiecutter grafik kullanıcı arabirimini yükleyerek.Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Bkz. Cookiecutter uzantısını kullanma.See Use the Cookiecutter extension.
    Python web desteğiPython web support HTML, CSS ve JavaScript Düzenle desteği dahil web geliştirme araçları 'nı, şişe, Flask ve Docgo çerçevelerini kullanan projelere yönelik şablonlarla birlikte kurar.Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Bkz. Python web projesi şablonları.See Python web project templates.
    Python IoT desteğiPython IoT support Python kullanarak Windows IoT Core geliştirmesini destekler.Supports Windows IoT Core development using Python.
    Python yerel geliştirme araçlarıPython native development tools Python için yerel uzantılar geliştirmek üzere C++ derleyicisini ve diğer gerekli bileşenleri yükleyerek.Installs the C++ compiler and other necessary components to develop native extensions for Python. Bkz. Python Için C++ uzantısı oluşturma.See Create a C++ extension for Python. Ayrıca, tam C++ desteği için C++ iş yüküne sahip masaüstü geliştirmeyi de yükler.Also install the Desktop development with C++ workload for full C++ support.
    Azure Cloud Services çekirdek araçlarıAzure Cloud Services core tools Python 'da geliştirici Azure Cloud Services için ek destek sağlar.Provides additional support for developer Azure Cloud Services in Python. Bkz. Azure bulut hizmeti projeleri.See Azure cloud service projects.
    SeçenekOption AçıklamaDescription
    Python dağıtımlarıPython distributions Birlikte çalışmayı planladığınız Python 2, Python 3, Miniconda, Anaconda2 ve Anaconda3 dağıtımlarının 32-bit ve 64-bit çeşitleri gibi kullanılabilir seçeneklerin herhangi bir birleşimini seçin.Choose any combination of the available options, such as 32-bit and 64-bit variants of the Python 2, Python 3, Miniconda, Anaconda2, and Anaconda3 distributions that you plan to work with. Her biri dağıtımın yorumlayıcı, çalışma zamanı ve kitaplıklarını içerir.Each includes the distribution's interpreter, runtime, and libraries. Anaconda, özellikle de önceden yüklenmiş çok sayıda paketi içeren açık bir veri bilimi platformudur.Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (Dağıtımları eklemek veya kaldırmak için dilediğiniz zaman Visual Studio yükleyicisine dönebilirsiniz.) Note: Visual Studio yükleyicisi dışında bir dağıtım yüklediyseniz, burada eşdeğer seçeneği denetlemeniz gerekmez.(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio, mevcut Python yüklemelerini otomatik olarak algılar.Visual Studio automatically detects existing Python installations. Bkz. Python ortamları penceresi.See The Python Environments window. Ayrıca, Python 'un daha yeni bir sürümü yükleyicide gösterilenden daha fazla kullanılabiliyorsa, bu sürümü ayrı olarak yükleyebilirsiniz ve Visual Studio bunu algılar.Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Cookiecutter şablonu desteğiCookiecutter template support Şablonları, giriş şablonu seçeneklerini bulmaya ve proje ve dosya oluşturmaya yönelik Cookiecutter grafik kullanıcı arabirimini yükleyerek.Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Bkz. Cookiecutter uzantısını kullanma.See Use the Cookiecutter extension.
    Python web desteğiPython web support HTML, CSS ve JavaScript Düzenle desteği dahil web geliştirme araçları 'nı, şişe, Flask ve Docgo çerçevelerini kullanan projelere yönelik şablonlarla birlikte kurar.Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Bkz. Python web projesi şablonları.See Python web project templates.
    Python yerel geliştirme araçlarıPython native development tools Python için yerel uzantılar geliştirmek üzere C++ derleyicisini ve diğer gerekli bileşenleri yükleyerek.Installs the C++ compiler and other necessary components to develop native extensions for Python. Bkz. Python Için C++ uzantısı oluşturma.See Create a C++ extension for Python. Ayrıca, tam C++ desteği için C++ iş yüküne sahip masaüstü geliştirmeyi de yükler.Also install the Desktop development with C++ workload for full C++ support.
    Azure Cloud Services çekirdek araçlarıAzure Cloud Services core tools Python 'da geliştirici Azure Cloud Services için ek destek sağlar.Provides additional support for developer Azure Cloud Services in Python. Bkz. Azure bulut hizmeti projeleri.See Azure cloud service projects.
  4. Yükleme sonrasında yükleyici, Visual Studio 'Yu değiştirme, başlatma, onarma veya kaldırma seçeneklerini sunar.After installation, the installer provides options to modify, launch, repair, or uninstall Visual Studio. Visual Studio güncelleştirmeleri yüklü herhangi bir bileşen için kullanılabilir olduğunda Değiştir düğmesi Güncelleştir olarak değişir.The Modify button changes to Update when updates to Visual Studio are available for any installed components. ( Değiştir seçeneği daha sonra açılan menüden kullanılabilir.) Ayrıca, "Visual Studio" üzerine arayarak Visual Studio ve yükleyiciyi Windows Başlat menüsünden de başlatabilirsiniz.(The Modify option is then available on the drop-down menu.) You can also launch Visual Studio and the installer from the Windows Start menu by searching on "Visual Studio".

    Yükleyiciden Visual Studio 'Yu başlatma, değiştirme, değiştirme veya kaldırma

Sorun gidermeTroubleshooting

Visual Studio 'da Python yükleme veya çalıştırma sorunlarıyla karşılaşırsanız şunları deneyin:If you encounter problems installing or running Python in Visual Studio, try the following:

  • Aynı hatanın, Python CLı kullanarak oluşup oluşmadığını belirleme, diğer bir deyişle, bir komut isteminden python.exe çalıştırma.Determine whether the same error occurs using the Python CLI, that is, running python.exe from a command prompt.
  • Visual Studio yükleyicisi 'ndeki Onar seçeneğini kullanın.Use the Repair option in the Visual Studio installer.
  • Windows 'daki Ayarlar > uygulamalar & Özellikler aracılığıyla Python 'u onarın veya yeniden yükleyin.Repair or reinstall Python through Settings > Apps & features in Windows.

Örnek hata: etkileşimli işlem başlatılamadı: System. ComponentModel. Win32Exception (0x80004005): Microsoft. PythonTools. REPL. PythonInteractiveEvaluator. D__43. MoveNext () adresinde bilinmeyen hata (0xc0000135).Example error: Failed to start interactive process: System.ComponentModel.Win32Exception (0x80004005): Unknown error (0xc0000135) at Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().

Visual Studio 2015Visual Studio 2015

  1. Visual Studio yükleyicisini Denetim masası > programlar ve Özellikler'den çalıştırın, Microsoft Visual Studio 2015 ' i seçip değiştirin.Run the Visual Studio installer through Control Panel > Programs and Features, selecting Microsoft Visual Studio 2015 and then Change.

  2. Yükleyicide Değiştir' i seçin.In the installer, select Modify.

  3. Programlama dillerini > Visual Studio için Python araçları ve ardından İleri' yi seçin:Select Programming Languages > Python Tools for Visual Studio and then Next:

    Visual Studio 2015 yükleyicisinde PTV seçeneği

  4. Visual Studio Kurulumu tamamlandıktan sonra, tercih ettiğiniz bir Python yorumlayıcı kurun.Once Visual Studio setup is complete, install a Python interpreter of your choice. Visual Studio 2015 yalnızca Python 3,5 ve öncesini destekler; sonraki sürümler Desteklenmeyen Python sürüm 3,6) gibi bir ileti oluşturur.Visual Studio 2015 supports only Python 3.5 and earlier; later versions generate a message like Unsupported Python version 3.6). Zaten yüklü bir yorumlayıcı varsa ve Visual Studio bunu otomatik olarak algılamazsa, bkz. mevcut bir ortamı el ilesaptama.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

Visual Studio 2013 ve önceki sürümlerVisual Studio 2013 and earlier

  1. Visual Studio sürümünüz için uygun Visual Studio için Python Araçları sürümünü yükler:Install the appropriate version of Python Tools for Visual Studio for your version of Visual Studio:

  2. Seçtiğiniz bir Python yorumlayıcı yükler.Install a Python interpreter of your choice. Zaten yüklü bir yorumlayıcı varsa ve Visual Studio bunu otomatik olarak algılamazsa, bkz. mevcut bir ortamı el ilesaptama.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

Konum yüklemeleriInstall locations

Varsayılan olarak, Python desteği bir bilgisayardaki tüm kullanıcılar için yüklenir.By default, Python support is installed for all users on a computer.

Visual Studio 2019 ve Visual Studio 2017 için Python iş yükü % ProgramFiles (x86)% \ Microsoft Visual Studio \<VS_version>\<VS_edition> < > 2017 2019 Common7\IDE\Extensions\Microsoft\Python ve VS_version < > Community, Professional veya Enterprise.For Visual Studio 2019 and Visual Studio 2017, the Python workload is installed in %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python where <VS_version> is 2019 or 2017 and <VS_edition> is Community, Professional, or Enterprise.

Visual Studio 2015 ve önceki sürümlerde, yükleme yolları aşağıdaki gibidir:For Visual Studio 2015 and earlier, installation paths are as follows:

  • 32 bit:32-bit:
    • Yol: % Program Files (x86)% \ Microsoft Visual Studio <VS_ver> \Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio \<PTVS_ver>Path: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • Yolun kayıt konumu: HKEY_LOCAL_MACHINE \software\microsoft\pythontools \<VS_ver> \ınstalldirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDir
  • 64 bit:64-bit:
    • Yol: % Program Files%\Microsoft Visual Studio <VS_ver> \Common7\IDE\Extensions\Microsoft\Python Tools for Visual studio \<PTVS_ver>Path: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • Yolun kayıt konumu: HKEY_LOCAL_MACHINE \software\wow6432node\microsoft\pythontools \<VS_ver> \ınstalldirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDir

burada:where:

  • <VS_ver > :<VS_ver> is:
    • Visual Studio 2015 için 14,014.0 for Visual Studio 2015
    • Visual Studio 2013 için 12,012.0 for Visual Studio 2013
    • Visual Studio 2012 için 11,011.0 for Visual Studio 2012
    • Visual Studio 2010 için 10,010.0 for Visual Studio 2010
  • <PTVS_ver, > 2.2.2, 2.1.1, 2,0, 1,5, 1,1 veya 1,0 gibi bir sürüm numarasıdır.<PTVS_ver> is a version number, such as 2.2.2, 2.1.1, 2.0, 1.5, 1.1, or 1.0.

Kullanıcıya özgü yüklemeler (1,5 ve önceki sürümler)User-specific installations (1.5 and earlier)

Yalnızca geçerli kullanıcı için Visual Studio için Python Araçları 1,5 ve önceki sürümlere izin verilir; Bu durumda yükleme yolu %LocalAppData%\microsoft\visualstudio \<VS_ver> \Extensions\Microsoft\Python Tools for Visual Studio \< PTVS_ver>, < VS_ver > ve < PTVS_ver > yukarıda açıklanan şekilde aynıdır.Python Tools for Visual Studio 1.5 and earlier allowed installation for the current user only, in which case the installation path is %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> where <VS_ver> and <PTVS_ver> are the same as described above.