Python in Visual Studio Code
AI agents: See llms.txt for documentation discovery and navigation. Documentation articles are also available as Markdown by appending .md to the article URL. Join VS Code at Microsoft Ignite or catch the sessions online. A year of VS Code, wrapped. Explore the highlights. Python in Visual Studio Code View as Markdown Ask in VS Code Ask in VS Code Insiders Working with Python in Visual Studio Code, using the Microsoft Python extension , is simple, fun, and productive.
The extension makes VS Code an excellent Python editor, and works on any operating system with a variety of Python interpreters. It leverages all of VS Code's power to provide auto complete and IntelliSense, linting, debugging, and unit testing, along with the ability to easily switch between Python environments, including virtual and conda environments. This article provides only an overview of the different capabilities of the Python extension for VS Code.
For a walkthrough of editing, running, and debugging code, use the button below. Python Tutorial Install Python and the Python extension The tutorial guides you through installing Python and using the extension. You must install a Python interpreter yourself separately from the extension. For a quick install, use Python from python.org and install the extension from the Visual Studio Marketplace . Note : To help get you started with Python development, you can use the Python profile template that includes useful extensions, settings, and Python code snippets.
Once you have a version of Python installed, select it using the Python: Select Interpreter command. If VS Code doesn't automatically locate the interpreter you're looking for, refer to select an environment . You can configure the Python extension through settings. Learn more in the Python Settings reference . Windows Subsystem for Linux : If you are on Windows, WSL is a great way to do Python development. You can run Linux distributions on Windows and Python is often already installed.
When coupled with the WSL extension, you get full VS Code editing and debugging support while running in the context of WSL. To learn more, go to Developing in WSL or try the Working in WSL tutorial. Run Python code To experience Python, create a file (using the File Explorer ) named hello.py and paste in the following code: print ( "Hello World" ) The Python extension then provides shortcuts to run Python code using the currently selected interpreter ( Python: Select Interpreter in the Command Palette).
To run the active Python file, click the Run Python File play button in the top-right side of the editor. You can also run individual lines or a selection of code with the Python: Run Selection/Line in Python Terminal command ( Shift+Enter ). If there isn't a selection, Smart Send will send the smallest runnable block of code around the line where your cursor is placed to the Python Terminal on ( Shift+Enter ). An identical Run Python > Run Selection/Line in Python Terminal command is available on the context menu for a selection in the editor.
The same terminal will be used every time you run a selection or a line in the terminal/REPL, until that terminal is closed. The same terminal is also used for Run Python File in Terminal . If that terminal is still running the REPL, you should exit the REPL ( exit() ) or switch to a different terminal before running a Python file. The Python extension automatically removes indents based on the first non-empty line of the selection, shifting all other lines left as needed.
The command opens the Python Terminal if necessary; you can also open the interactive REPL environment directly using the Python: Start Terminal REPL command that activates a terminal with the currently selected interpreter and then runs the Python REPL. For a more specific walkthrough and other ways of running code, see the run code tutorial . Autocomplete and IntelliSense The Python extension supports code completion and IntelliSense using the currently selected interpreter.
IntelliSense is a general term for a number of features, including intelligent code completion (in-context method and variable suggestions) across all your files and for built-in and third-party modules. IntelliSense quickly shows methods, class members, and documentation as you type. You can also trigger completions at any time with ⌃Space (Windows, Linux Ctrl+Space ) . Hovering over identifiers will show more information about them.
Enhance completions with AI GitHub Copilot provides coding suggestions as you type in your editor. You can also ask Copilot coding-related questions, such as how best to code something, how to fix a bug, or how someone else's code works. Learn how to get started with AI in VS Code . Linting Linting analyzes your Python code for potential errors, making it easy to navigate to and correct different problems. The Python extension can apply a number of different linters including Pylint, pycodestyle, Flake8, mypy, pydocstyle, prospector, and pylama.
See Linting . Debugging No more print statement debugging! VS Code comes with great debugging support for Python via the Python Debugger extension , allowing you to set breakpoints, inspect variables, and use the debug console for an in-depth look at how your program is executing step by step. Debug a number of different types of Python applications, including multi-threaded, web, and remote applications. For more specific information on debugging in Python, such as configuring your launch.json settings and implementing remote debugging, see Debugging .
General VS Code debugging information is found in the debugging document . Additionally, the Django and Flask tutorials provide examples of how to implement debugging in the context of web applications, including debugging Django templates. Environments The Python extension automatically detects Python interpreters that are installed in standard locations. It also detects conda environments as well as virtual environments in the workspace folder.
See Configuring Python environments . The current environment is shown on the right side of the VS Code Status Bar: The Status Bar also indicates if no interpreter is selected: The selected environment is used for IntelliSense, auto-completions, linting, formatting, and any other language-related feature. It is also activated when you run or debug Python in a terminal, or when you create a new terminal with the Terminal: Create New Terminal command.
To change the current interpreter, which includes switching to conda or virtual environments, select the interpreter name on the Status Bar or use the Python: Select Interpreter command. VS Code prompts you with a list of detected environments as well as any you've added manually to your user settings (see Configuring Python environments ). Jupyter notebooks To enable Python support for Jupyter notebook files ( .ipynb ) in VS Code, you can install the Jupyter extension .
The Python and Jupyter extensions work together to give you a great Notebook experience in VS Code, providing you the ability to directly view and modify code cells with IntelliSense support, as well as run and debug them. You can also convert and open the notebook as a Python code file through the Jupyter: Export to Python Script command. The notebook's cells are delimited in the Python file with #%% comments, and the Jupyter extension shows Run Cell or Run Below CodeLens.
Selecting either CodeLens starts the Jupyter server and runs the cell(s) in the Python interactive window: You can also connect to a remote Jupyter server to run your notebooks. For more information, see Jupyter support . Testing The Python extension supports testing with Python's built-in unittest framework and pytest. In order to run tests, you must enable one of the supported testing frameworks in the settings of your project.
Each framework has its own specific settings, such as arguments for identifying the paths and patterns for test discovery. Once the tests
The rest of this page is on the live site.