How to Install and Configure VS Code on Windows

Published on: July 7, 2026
Reading time: 8 minutes
Logo do VS Code em um fundo escuro

The Visual Studio Code (VS Code) is one of the most widely used code editors in the world. Built by Microsoft, it combines a lightweight footprint with strong performance and a rich extension ecosystem. In this guide, you will learn how to install and configure VS Code on Windows step by step, even if you have never touched the tool before.


What Is VS Code?

VS Code is a free, cross-platform source code editor available for Windows, macOS, and Linux.
It is a great fit for anyone writing Python, JavaScript, C++, Java, HTML, and dozens of other languages.

Unlike heavier, full-blown IDEs, VS Code stays fast and responsive while remaining fully customizable through extensions. You can shape the environment around your own workflow instead of adapting to a rigid tool.


Why Use VS Code on Windows?

Before installing, it helps to understand why this editor became so popular:

  • Free and lightweight. It runs comfortably even on machines with limited memory.
  • Highly customizable. Install themes, icon packs, extensions, and custom keyboard shortcuts.
  • Multi-language support. Works with Python, JavaScript, HTML, Java, and many others.
  • Built-in Git and GitHub integration. Version and publish projects straight from the editor.
  • Integrated terminal. Run commands without leaving the editor window.

These features make the editor a solid choice for beginners and experienced developers alike.


System Requirements for VS Code on Windows

Before starting the installation, check that your computer meets the minimum requirements:

RequirementDescription
Operating systemWindows 10 or newer
RAM1 GB (4 GB or more recommended)
Disk spaceAround 300 MB
Internet connectionNeeded to download the installer and extensions

If your machine meets these requirements, you are ready to move on.


How to Download VS Code

  1. Go to the official site: https://code.visualstudio.com/
  2. Click the Download for Windows button.
  3. Wait for the installer file to finish downloading (VSCodeSetup-x64.exe).

Always download the installer from the official website to avoid fake or corrupted builds.


Installing VS Code Step by Step

Once the installer has downloaded, follow these steps:

  1. Run the installer. Double-click the downloaded file.
  2. Accept the license agreement. Check “I accept the agreement” and click Next.
  3. Choose the install location. The default is usually C:\Program Files\Microsoft VS Code. You can leave it as is and click Next.
  4. Select the additional tasks. Check these boxes:
    • Add to PATH (recommended)
    • Register Code as an editor for supported file types
    • Add “Open with Code” action to Windows Explorer
    These options let you launch VS Code straight from the Windows menu and context menus.
  5. Finish the installation. Click Install and wait. When it finishes, check “Launch Visual Studio Code” to open the app.

Done. VS Code is now installed on your computer.

If the terminal later complains that a command cannot be found, it is usually a PATH issue rather than a VS Code problem. This guide on how to fix the “Python is not recognized” error on Windows walks through the same PATH concept in detail.


First Steps After Installation

The first time you open the program, you will see a simple, intuitive start screen. Here are a few basic actions to get going.

1. Switch the Display Language

  1. Click View → Command Palette (or press Ctrl + Shift + P).
  2. Type “Configure Display Language.”
  3. Click “Install additional languages.”
  4. Search for your preferred language pack and click Install.
  5. Restart VS Code.

The menus and messages will now appear in your chosen language.


2. Install Essential Extensions

The real strength of VS Code lives in its extensions. To install one:

  1. Click the Extensions icon on the left sidebar (or use Ctrl + Shift + X).
  2. Search for and install these popular picks:
    • Python: syntax support, code execution, and debugging. It pairs well with a proper debugging workflow using pdb when you need to step through tricky logic.
    • Prettier: automatically formats your code.
    • Live Server: great for HTML and CSS, spins up a local server instantly.
    • GitLens: advanced Git integration, useful once you start automating tests with GitHub Actions.
    • Material Icon Theme: improves the visual clarity of file icons.

These extensions make the editor considerably more complete and productive for day-to-day coding.


3. Customize the Visual Theme

VS Code ships with several built-in appearance themes. To change the look:

  1. Click File → Preferences → Theme → Color Theme.
  2. Try out Dark+, Light+, or Monokai.
  3. You can also install additional themes from the Extensions tab.

Customization helps keep the environment comfortable during long coding sessions.


Configuring the Integrated Terminal

The integrated terminal lets you run commands without leaving the editor.
Open it with Ctrl + ` (backtick).

By default, the terminal usually opens PowerShell, but you can change it:

  1. Click the arrow next to the terminal name.
  2. Choose Select Default Profile.
  3. Pick Command Prompt (cmd) or Git Bash, if you installed Git for Windows.

This is also the right place to load project secrets. If your scripts read configuration from a .env file, take a look at how to read environment variables in Python safely before running anything in this terminal.


Writing and Running Your First Script

Let’s confirm that everything is working correctly.

  1. Create a new folder on your computer, such as C:\projects.
  2. In VS Code, click File → Open Folder and select that folder.
  3. Click New File and save it as test.py.
  4. Type the code below:
print("Hello, VS Code!")
  1. Click Run → Run Without Debugging (or Ctrl + F5).

If the message shows up in the terminal, VS Code is ready to use. Once you are comfortable running scripts this way, you might also want to turn your Python scripts into standalone executables or package them inside a container with this guide on how to run a Python script in Docker.


Useful VS Code Shortcuts

Learning a handful of shortcuts helps you move faster:

ActionShortcut
Open new tabCtrl + N
Save fileCtrl + S
Run codeCtrl + F5
Search in projectCtrl + Shift + F
Toggle line commentCtrl + /
Integrated terminalCtrl + `
Switch between tabsCtrl + Tab

These are just a few examples. You can customize every shortcut under File → Preferences → Keyboard Shortcuts.


Tips to Keep VS Code Running Fast

Even though it is lightweight, performance can improve further with a few habits:

  • Uninstall extensions you no longer use.
  • Close tabs that are not in use.
  • Keep VS Code updated at all times.
  • Stick to simple themes without heavy animations.

These actions reduce memory usage and keep the editor snappy, which also helps if you juggle multiple virtual environments managed with Poetry.


Troubleshooting Common Issues

ProblemLikely causeFix
VS Code will not openCorrupted installationReinstall the program
Terminal errorsPATH not configuredReinstall with “Add to PATH” checked
Extensions will not installNetwork failureCheck your connection and try again
Slow performanceToo many extensionsDisable the ones you do not use

These simple fixes typically get the editor back to normal quickly. Consult the official VS Code documentation for deeper troubleshooting on specific extensions or settings.


Conclusion

VS Code is an essential tool for anyone coding on Windows. With it, you can write, run, and test code in many languages in a practical, streamlined way.

After following this guide, you should have VS Code installed, configured, and ready to go. Now it is time to start building your own projects. If you want a structured path through the language itself, our Complete Python Course is a good next step.


Frequently Asked Questions (FAQ)

1. What is VS Code?
A free, lightweight code editor built by Microsoft.

2. Is VS Code free?
Yes, it is completely free and open source.

3. Does VS Code need internet to work?
Only to install the program and download extensions.

4. Does VS Code run on any Windows version?
It works from Windows 10 onward.

5. Can I change the display language?
Yes, just install the matching language pack extension.

6. Does VS Code run Python?
Yes, once you install the official “Python” extension.

7. Can I use VS Code without installing anything extra?
Yes, but extensions significantly improve the experience.

8. How do I open the terminal in VS Code?
Press Ctrl + ` (backtick).

9. Is VS Code an IDE?
Technically it is a code editor, but with extensions it can behave like a full IDE.

10. Is VS Code safe?
Yes, as long as you download it from the official Microsoft site.

11. Can I uninstall VS Code easily?
Yes, like any other Windows program.

12. Does VS Code save automatically?
You can enable this under Settings → Auto Save.


Share:

Facebook
WhatsApp
Twitter
LinkedIn

Article content

    Related articles

    Transformando scripts Python em executáveis para Windows
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Create Executable Python Scripts Easily

    Learn to create executable Python scripts using PyInstaller: set up a virtual environment, build a single-file .exe, add an icon,

    Ler mais

    Tempo de leitura: 3 minutos
    03/06/2026
    Transformando script Python em executável EXE rapidamente
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Convert Python Script to .exe in 5 Minutes

    Convert your Python script to .exe in 5 minutes using PyInstaller: virtual environment setup, single-file build, no-console flag, custom icon,

    Ler mais

    Tempo de leitura: 5 minutos
    03/06/2026
    Publicação de pacote Python no PyPI em poucos minutos
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Publish Your Python Package to PyPI in 5 Min

    Learn how to publish your Python package to PyPI in 5 minutes: project structure, pyproject.toml, build, API tokens, Twine upload,

    Ler mais

    Tempo de leitura: 6 minutos
    03/06/2026
    Execução de scripts Python com Docker em containers
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Run Your Python Script in Docker in 5 Minutes

    Run your Python script in Docker in 5 minutes: write a Dockerfile, build an image, run a container, pass environment

    Ler mais

    Tempo de leitura: 4 minutos
    31/05/2026
    Gerenciamento de dependências Python com Poetry
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Manage Python Dependencies with Poetry

    Learn how to manage Python dependencies with Poetry: install it, add/remove packages, understand poetry.lock, use dev groups, Docker integration, and

    Ler mais

    Tempo de leitura: 4 minutos
    31/05/2026
    Criação de ambiente Conda para projetos Python
    IDEs and Tools
    Foto de perfil de Leandro Hirt da Academify

    Create a Python Conda Environment in Minutes

    Learn how to create a Conda environment for Python in minutes: install Miniconda, activate environments, install packages, export to YAML,

    Ler mais

    Tempo de leitura: 4 minutos
    31/05/2026