1. A Unified Solution for Environment Management
Python development has long suffered from fragmented environment tools like venv, conda, pyenv, poetry, and pipenv. The new Python Environments Extension for VS Code brings everything under one roof. After a year in preview, it’s now generally available. This extension automatically takes over all environment workflows, so you can stop juggling different UIs and commands. Simply open a Python file, and your environments are discovered and managed from a single interface. No setup required—just install the extension alongside the Python extension, and you’re ready to go. Whether you’re a beginner or an expert, this tool cuts the clutter and gives you consistent, reliable control over your Python environments.
2. Automatic Discovery of All Major Environment Managers
The extension seamlessly discovers environments created by venv, conda, pyenv, poetry, pipenv, and system Python installs. Instead of manually searching for virtual environments, the extension scans your system and lists them in a dedicated view. This automatic detection works across Windows, macOS, and Linux, ensuring you always see every environment you have. The discovery engine is powered by PET (Python Environment Tool), a Rust-based scanner that is fast and reliable. It checks your PATH, standard installation directories, and any custom search paths you configure. The result? You never have to wonder where an environment is again.
3. Blazing-Fast Scanning with Python Environment Tool (PET)
PET is the backbone of the extension’s discovery capabilities. Written in Rust for speed, it scans your system for Python environments in milliseconds. It’s the same engine already used in the existing Python extension, so you know it’s proven. PET looks at your PATH environment variable, well-known installation folders (like .venv in project directories), and any custom paths you add at the workspace or global level. If you have environments in non-standard locations, no problem—you can configure glob patterns to find them. This fast scanning ensures that the environment view is always up-to-date without slowing down your workflow.
4. Flexible Configuration for Non-Standard Paths
While the extension works out of the box for most users, it also offers powerful configuration options. If you keep your environments in shared directories outside your workspace or in non-standard locations, you can add custom search paths. Use glob patterns at the workspace level to include specific folders, or set global search paths for system-wide locations. This flexibility means that even in complex setups—like corporate environments with locked-down folders—the extension can discover everything. The settings are accessible via VS Code’s settings UI, making it easy to tweak without editing JSON files.
5. Automatic Speed Boost with uv for Creation and Package Installation
If you have uv installed, the extension automatically uses it when creating venv environments and installing packages. uv is a fast, modern Python package installer and resolver that outperforms traditional tools, especially in large projects with many dependencies. This speed boost is enabled by default via the python-envs.alwaysUseUv setting. You don’t have to do anything extra—the extension detects uv and uses it transparently. For large monorepos or projects with complex dependency trees, this can cut environment creation time from minutes to seconds.
6. Quick Create: One-Click Environment Setup
The extension’s Quick Create feature (the + button in the Environment Managers view) lets you create a new environment with a single click. It automatically uses your default environment manager (e.g., venv or conda), picks the latest available Python version, and scans for dependency files like requirements.txt or pyproject.toml in your workspace. In just a few seconds, you have a working environment ready for development. This is perfect for quickly spinning up a clean environment for a new project or testing a different Python version without diving into CLI commands.
7. Custom Create: Full Control When You Need It
For scenarios where you need more control, the Custom Create option (accessible via Python: Create Environment in the Command Palette) lets you specify every detail. Choose your environment manager (venv or conda are supported for direct creation), select a specific Python version, name your environment, and pick which dependency files to install from. For managers like pyenv, poetry, and pipenv, the extension discovers environments you create with their CLI tools. This flexibility ensures that power users can fine-tune their setups while still benefiting from the unified UI.
8. Python Projects: Mapping Environments to Code Structure
One of the extension’s standout features is Python Projects, which allows you to map environments to specific folders or files. This is a game-changer for monorepos or multi-project workspaces where different code sections require different dependencies. Instead of manually switching environments, you can assign an environment to each project folder. The extension automatically activates the correct environment when you open a file in that folder. This eliminates confusion and ensures that each part of your codebase gets the right Python version and packages. It’s a simple concept that solves a common pain point in larger projects.
9. Seamless Integration with the Python Extension
The Python Environments Extension works hand-in-hand with the main Python extension for VS Code. You don’t need to replace anything—just install the environments extension, and it enhances your existing workflow. All environment-related actions (like selecting an interpreter, running tests, or debugging) automatically use the unified environment manager. The extension respects your existing settings and preferences, so there’s no learning curve. Whether you’re using Jupyter notebooks, linting, or the debugger, the environment you’ve chosen is consistently applied.
10. General Availability and Opt-In Process
After extensive feedback and refinement during its preview phase, the extension is now being rolled out for general availability. In the coming weeks, most users will automatically have all environment workflows switched to use the new extension. If you’re eager to try it immediately, you can opt in by setting python.useEnvsExtension to true in your VS Code settings. There’s no need to uninstall any existing tools—the extension coexists with them and enhances their discovery. This gradual rollout ensures a smooth transition for all users. Welcome to a cleaner, faster, and more unified Python environment experience!