10 Essential Features of the New Python Environments Extension for VS Code

Python development in VS Code has historically required juggling tools like venv, conda, pyenv, poetry, and pipenv, each with its own interface. The new Python Environments Extension brings all of this under one roof, offering a unified workflow for managing environments, interpreters, and packages. After a year in preview—refined by community feedback—it's now generally available. Here are ten things you need to know to get the most out of it.

1. Unified Environment Management

The extension automatically discovers environments from all major Python managers: venv, conda, pyenv, poetry, pipenv, and system Python installs. This means you no longer need to remember which tool created which environment. A single UI lets you create, delete, switch, and manage environments regardless of their origin. This unification eliminates the fragmentation that has long frustrated Python developers, allowing you to focus on coding rather than tool wrangling.

2. Powered by PET – The Rust-Based Scanner

Behind the scenes, the extension uses PET (Python Environment Tool), a fast Rust-based scanner that reliably finds environments across all platforms. PET checks your PATH, known installation locations, and any configurable search paths. It already powers environment discovery in the standard Python extension, so you're getting a proven engine. The new dedicated UI simply wraps this speed and reliability in a user-friendly interface, making environment detection instant and accurate.

3. Out-of-the-Box Discovery and Customizable Paths

For most users, environments work automatically as soon as you open a Python file. If you keep environments in non-standard locations, you can configure workspace-level search paths using glob patterns. Alternatively, set global search paths for shared directories outside your workspace. This flexibility ensures that even complex project layouts—like monorepos or shared network drives—are fully supported without manual intervention.

4. Faster Environment Creation with uv

If you have uv installed (a modern, fast Python package manager), the extension automatically uses it for creating venv environments and installing packages. This is significantly faster than standard tools, especially in large projects with many dependencies. The feature is enabled by default via the python-envs.alwaysUseUv setting, giving you an instant speed boost without additional configuration.

5. Quick Create for Instant Setup

Getting a new environment up and running is now a single click. The Quick Create button (a + in the Environment Managers view) builds an environment using your default manager, the latest Python version, and any workspace dependencies it finds in requirements.txt or pyproject.toml. In seconds, you have a working environment that matches your project's needs—no command-line fiddling required.

6. Custom Create for Full Control

When you need more granular control, use Custom Create via the Python: Create Environment command in the Command Palette. Here you can choose your preferred environment manager (e.g., venv or conda), select a Python version, name the environment, and specify which dependency files to install from. For managers like pyenv, poetry, and pipenv, the extension discovers environments you create with their respective CLI tools, but creation itself happens outside VS Code—offering the best of both worlds.

7. Python Projects: Env-to-Code Mapping

Python Projects let you map specific environments to particular folders or files. This solves a classic pain point in monorepos where different subprojects require different Python versions or dependency sets. Instead of manually switching environments as you move between code sections, you can define rules that auto-activate the right environment based on the file you're editing. This feature brings order to complex codebases and boosts productivity for large-scale Python development.

8. Seamless Integration with the Python Extension

The Python Environments Extension works alongside the existing Python extension without any setup. Open a Python file, and environments are discovered automatically. All familiar features—like the status bar interpreter selector, debugging, and IntelliSense—remain unchanged but become smarter because they are backed by the unified environment manager. There's no disruption to your current workflow; only the underlying infrastructure improves.

9. General Availability After a Successful Preview

The extension spent a full year in preview, during which the team actively incorporated community feedback. This collaborative approach ensured that real-world use cases—like non-standard environment locations, large monorepos, and varied package managers—were addressed before the general release. The result is a polished tool that meets the needs of both casual developers and power users, backed by a rigorous testing process.

10. Transition and Opt-In Mechanism

Over the next few weeks, all environment workflows in VS Code will automatically switch to using the new extension. If you prefer to adopt it immediately, set python.useEnvsExtension to true in your settings. The transition is designed to be seamless—no data loss, no configuration changes. For those who want to wait, the old behavior remains available until the automatic rollout completes. Either way, you benefit from a unified, faster, and more reliable environment management experience.

From unified discovery and Rust-powered scanning to faster creation with uv and intelligent project mapping, the Python Environments Extension modernizes Python development in VS Code. Whether you're managing a single script or a multi-module monorepo, this extension reduces overhead and lets you focus on writing code. Try it today by enabling the setting or waiting for the automatic update—your Python workflow will thank you.