A Visual Studio Code extension with rich support for the Python language (including Python 3.6), including features such as linting, debugging, IntelliSense, code navigation, code formatting, refactoring, unit tests, snippets, and more!

• Step 1. Install a supported version of Python on your system (note: that the system install of Python on macOS is not supported).
• Step 2. Install the Python extension for Visual Studio Code.
• Step 3. Open or create a Python file and start coding!

• Step 4. Install a linter to get errors and warnings -- you can further customize linting rules to fit your needs.
• Step 5. Select your preferred Python interpreter/version/environment using the Select Interpreter command.
  • By default we use the one that's on your path.
  • If you have a workspace open you can also click in the status bar to change the interpreter.
• Step 6. Install ctags for Workspace Symbols, from here, or using brew install ctags on macOS.

For more information you can:

• Follow our Python tutorial with step-by-step instructions for building a simple app.
• Check out the Python documentation on the VS Code site for general information about using the extension.

Open the Command Palette (Command+Shift+P on macOS and Ctrl+Shift+P on Windows/Linux) and type in one of the following commands:

To see all available Python commands, open the Command Palette and type Python.

The extension is available in multiple languages thanks to external contributors (if you would like to contribute a translation, see the pull request which added Italian):

• en
• es
• fr
• it
• ja
• ko-kr
• pt-br
• ru
• zh-cn
• zh-tw

• If you have a question about how to accomplish something with the extension, please ask on Stack Overflow
• If you come across a problem with the extension, please file an issue
• Contributions are always welcome! Please see our contributing guide for more details
• Any and all feedback is appreciated and welcome!
  • If someone has already file an issue that encompasses your feedback, please leave a 👍/👎 reaction on the issue
  • Otherwise please file a new issue
• If you're interested in the development of the extension, you can read about our development process

• IDE-like features
  • Automatic indenting
  • Code navigation ("Go to", "Find all" references)
  • Code definition (Peek and hover definition, View signatures)
  • Rename refactoring
  • Sorting import statements (use the Python: Sort Imports command)
• Intellisense and autocomplete (including PEP 484 and PEP 526 support)
  • Ability to include custom module paths (e.g. include paths for libraries like Google App Engine, etc.; use the setting python.autoComplete.extraPaths = [])
• Code formatting
  • Auto formatting of code upon saving changes (default to 'Off')
  • Use either yapf, autopep8, or Black for code formatting (defaults to autopep8)
• Linting
  • Support for multiple linters with custom settings (default is Pylint, but Prospector, Flake8, pylama, pydocstyle, and mypy are also supported)
• Debugging
  • Watch window
  • Evaluate expressions
  • Step through code ("Step in", "Step out", "Continue")
  • Add/remove breakpoints
  • Local variables and arguments
  • Multi-threaded applications
  • Web applications (such as Flask & Django, with template debugging)
  • Expanding values (viewing children, properties, etc)
  • Conditional breakpoints
  • Remote debugging (over SSH)
  • Google App Engine
  • Debugging in the integrated or external terminal window
  • Debugging as sudo
• Unit testing
  • Support for unittest, pytest, and nose
  • Ability to run all failed tests, individual tests
  • Debugging unit tests
• Snippets
• Miscellaneous
  • Running a file or selected text in python terminal
• Refactoring
  • Rename refactorings
  • Extract variable refactorings
  • Extract method refactorings
  • Sort imports

The Microsoft Python Extension for Visual Studio Code collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. This extension respects the telemetry.enableTelemetry setting which you can learn more about at https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting.