how to set up virtual environment in vscode with code examples

Virtual environments are essential when using Python because they allow you to create an isolated environment for your project dependencies. Even if you have multiple projects with different dependencies, you can easily switch between them without worrying about conflicts. In this tutorial, we will guide you through how to set up a virtual environment in Visual Studio Code.

What is a Virtual Environment?

A virtual environment is a tool that enables you to create a standalone Python environment with its own set of modules, packages, and Python version. Virtual environments allow you to work on multiple Python projects, each with their own dependencies without causing conflicts between them.

Why Use a Virtual Environment?

Using a virtual environment, you can avoid dependency problems very easily as one project can have one version of any particular library installed while another project can have a different version installed.

Virtual environments offer other benefits as well, which can make your Python development tasks easier. By setting up a virtual environment, you can improve the following:

  1. Lowers Development Time – You need not alter your primary Python installation setup. All libraries utilized only within the virtual environment will be saved within the created environment. Therefore, after switching to another project, you can just activate the environment and begin working.

  2. Isolated Environments – Create an environment isolated from your system’s installations, including Python itself.

  3. Avoids Package Conflicts – When working on various projects at the same time, you might have some package versions that conflict with one another. Virtual environments let you have as many versions of a “package” installed as possible, without the worry of interference.


To follow along with this tutorial, you will need:

  • Python 3.x installed in your system
  • Visual Studio Code (VSCode) IDE – latest version.
  • Basic knowledge of Python concepts.

Steps to Set Up a Virtual Environment in VSCode

Now that you understand the importance of virtual environment setup let’s start with the actual process of setting up a virtual environment in VSCode. There are two different ways to create and activate a virtual environment in VSCode:

  1. Using the terminal directly in VSCode
  2. Using the VSCode commands

Regardless of which method you choose, the first step is to open up a terminal window inside of VSCode.

1. Create a Virtual Environment

Let’s say you have a project that requires a particular set of dependencies. To set up a virtual environment for that project, you need to follow these steps:

  1. Open the terminal by pressing Ctrl + ` (or through a search command)
  2. In the terminal (make sure your current directory is where you want to set up this environment), type python -m venv venv. Here, the name venv is the desired name of your virtual environment. Once you press Enter, a new directory (with the name enclosed within venv) will be created with the Python environment files.

Here, -m venv will name the environment based on the file name you specify.

Create a Virtual Environment

2. Activate a Virtual Environment

After the Venv is created, you can activate the environment. This means you will use the newly-created environment for all Python project tasks rather than the main system Python environment. Let’s activate the environment:

  1. Go to the newly-created directory in the terminal by using cd venv
  2. Type source bin/activate if you are using Linux / MacOS or .\bin\Activate.ps1 if you are using Windows.
  3. To deactivate the environment after you have finished working with it, type deactivate in the terminal.

Activate a Virtual Environment

After these steps have been completed, the terminal will indicate that the virtual environment has been activated. The newly-created environment contains an isolated Python installation along with any additional necessary packages you require for your project.

3. Using VSCode Commands

If you wish to use a virtual environment within VSCode, the VSCode “Command Palette” support makes it simple to create, activate, and delete environments without having to use commands through the terminal.

  1. Go to the VSCode “Command Palette” by pressing Ctrl + Shift + P (for Windows/Linux) or CMD + Shift + P (for Mac).
  2. Type ‘Python: Select Interpreter’ command and you will see a list of interpreters available for your project.
  3. Select the “venv” interpreter, and it will be used as the current active environment. VSCode will also display a prompt notifying you that a new environment has been established.

Using VSCode Commands

4. Install Required Python Libraries and Modules

After your virtual environment is activated, you can install new packages or updates for previously installed libraries just as you normally would on your main system Python environment. A pip install of libraries is one way to get it done.

Type pip install libraryname in the terminal to install any package you would like to add to your virtual environment.


Virtual environments are fantastic tools. They can resolve dependency issues and keep your environments separate, among other things. With Visual Studio Code, creating new environments is a straightforward process. You can create as many virtual environments as you require, and they can be switched easily using either the command-palette support or the terminal.

By following these simple guidelines, you can set up and manage a virtual environment inside of VSCode quite efficiently.

let me provide some more information on the topics discussed earlier.

Why Use a Virtual Environment?

As mentioned earlier, virtual environments can be really helpful in managing dependencies and avoiding conflicts when working on multiple Python projects. In other words, virtual environments allow you to have isolated and independent Python environments for different projects. This means that even if one project requires a specific version of a library or module, it won't interfere with others.

Another advantage of virtual environments is that they can prevent your system-wide Python packages from being modified by mistake while working on a project. This is particularly important when you are working with different versions of packages or modules.

Virtual environments can also improve the portability of your code, as other developers can easily set up the same environment and dependencies as you have. This can help avoid version conflicts and ensure that everyone is using the same packages and modules.

Setting Up a Virtual Environment in VSCode

There are two ways to set up a virtual environment in VSCode: using the terminal and using the VSCode commands. Using the terminal can be useful if you are already comfortable using the command line interface, and it provides greater control over the process. However, using the VSCode commands is a more straightforward and user-friendly option.

Once you have set up your virtual environment, you can activate it using the terminal or through the VSCode command palette. After the environment is activated, you can install the required dependencies using pip commands.

Installing Required Python Libraries and Modules

Once your virtual environment is setup and activated, you can start installing the required Python packages or modules using pip commands. Pip simply stands for "Pip Installs Packages". This is a Python package manager that makes it easy to install and manage third-party packages and libraries in Python. To install a package, simply type pip install <package-name> in your terminal. For example, to install the NumPy package, you would type pip install numpy.

It is a good practice to keep track of all the required packages and their versions in a separate file called requirements.txt. This makes it easier to recreate the same environment and dependencies on another machine or for other team members. To generate a requirements.txt file, type pip freeze > requirements.txt in your activated environment. This will create a file with a list of all the installed packages and their versions.


In summary, setting up a virtual environment in VSCode can be a useful technique to manage dependencies and keep your Python code isolated and organized. By following the steps outlined in this article, you can create, activate, and manage virtual environments for your Python projects. Additionally, using pip to install and manage packages can make your development workflow much smoother and efficient.

Popular questions

Sure, here are five questions related to setting up a virtual environment in VSCode, along with their answers:

  1. What is a virtual environment in Python?

A virtual environment in Python is an isolated environment that contains a specific version of the Python interpreter as well as any libraries and packages necessary for a particular project. It allows developers to separate dependencies and package requirements between projects.

  1. What are the benefits of using a virtual environment?

Using a virtual environment can help you manage dependencies, avoid package conflicts, and improve portability of your code. It also allows you to work on multiple projects with different dependencies without interfering with each other and keeps your system-wide Python packages from being modified by mistake.

  1. How can you set up a virtual environment in VSCode?

There are two ways to set up a virtual environment in VSCode: using the terminal and using the VSCode commands. In the terminal, you should use the command python -m venv <env-name> to create a virtual environment and then activate it with source <env-name>/bin/activate. With VSCode, you can use the command palette to select the interpreter or create a new virtual environment.

  1. How can you install required Python libraries and modules in a virtual environment?

Once your virtual environment is activated, you can use pip to install required Python libraries and modules. Simply type pip install <package-name> in the terminal to install a package, or pip freeze > requirements.txt to generate a list of installed packages and versions.

  1. Why is it important to keep track of installed packages and their versions in a requirements.txt file?

Creating a requirements.txt file that lists installed packages and their versions helps to recreate the same environment and dependencies on another machine or for other team members. This ensures consistency between development environments and avoids version conflicts.



As a senior DevOps Engineer, I possess extensive experience in cloud-native technologies. With my knowledge of the latest DevOps tools and technologies, I can assist your organization in growing and thriving. I am passionate about learning about modern technologies on a daily basis. My area of expertise includes, but is not limited to, Linux, Solaris, and Windows Servers, as well as Docker, K8s (AKS), Jenkins, Azure DevOps, AWS, Azure, Git, GitHub, Terraform, Ansible, Prometheus, Grafana, and Bash.

Leave a Reply

Your email address will not be published. Required fields are marked *

Related Posts

Begin typing your search term above and press enter to search. Press ESC to cancel.

Back To Top