How to Install Visual Studio Code on Ubuntu The Ultimate Guide

I remember the first time I decided to dive into coding on Ubuntu – I was both excited and a bit overwhelmed. If you’re anything like me, you probably want a powerful yet user-friendly code editor that can handle everything from simple scripts to complex applications. Enter Visual Studio Code, or VS Code for short. This robust tool has quickly become a favorite among developers for its versatility and extensive features. Not only is it free, but it also offers a vast array of extensions to customize your coding experience.

How to Install Visual Studio Code on Ubuntu: The Ultimate Guide

In this ultimate installation guide, I’m going to walk you through the steps to get Visual Studio Code up and running on your Ubuntu system. Whether you’re a seasoned pro or just starting, installing VS Code is a breeze with the right instructions. I’ll share my insights and tips to make the process smooth and hassle-free, so you can focus on what truly matters – writing great code.

From installation methods to essential post-installation tweaks, I’ll cover everything you need to know to set up your development environment effectively. So, grab your favorite mug of coffee, and let’s get started on this coding journey together. By the end of this guide, you'll be equipped to launch your projects in VS Code and unlock its full potential. Let’s dive in!

Why I Stopped Wrestling With Ubuntu Text Editors

I'll never forget my first week with Ubuntu, staring at terminal windows and wrestling with basic text editors that felt like trying to write a novel with stone tablets. The frustration was real. Then I discovered Visual Studio Code, and it transformed my entire development workflow. Over the years, I've installed VS Code on countless Ubuntu machines – from fresh desktop installations to headless servers – and I've learned exactly what works, what doesn't, and why the installation method you choose matters more than you might think.

This guide isn't just another quick tutorial. It's the comprehensive resource I wish I'd had when I started, drawing from hundreds of installations across different Ubuntu versions. We'll explore every installation method in depth, examine their trade-offs, and I'll share the specific approach I use today for my production development environments.

Understanding Your Installation Options: More Than Just a Quick Command

Before we dive into the technical steps, it's crucial to understand that how you install VS Code on Ubuntu significantly impacts your experience with updates, stability, and available features. There are four primary installation methods, each with distinct advantages and use cases.

Method 1: Snap Package (The Default Approach)

The Snap method provides the most straightforward installation path, which is why it's often the first result in search queries. Snap packages are containerized applications that bundle their dependencies, ensuring consistent behavior across different Linux distributions.

When to choose this method: Ideal for beginners, quick setups, or when you need isolation from system dependencies.

Method 2: Official Microsoft Repository (My Preferred Method)

By adding Microsoft's official APT repository, you get a native Debian package that integrates more seamlessly with your system while still providing automatic updates directly from Microsoft.

When to choose this method: Perfect for production development environments where you want system integration without containerization overhead.

Method 3: Direct .deb Package Download

This approach involves manually downloading and installing the Debian package, useful when you're working on air-gapped systems or need to install specific versions.

When to choose this method: Only when other methods aren't available or for version-specific installations.

Method 4: Flatpak Alternative

Flatpak provides another containerized approach through the Flathub repository, offering similar isolation benefits to Snap with a different underlying technology.

When to choose this method: If you're already using Flatpak for application management on your Ubuntu system.

How to Install VSCode on Linux: Comparison Table

How to Install Visual Studio Code on Ubuntu: Step-by-Step Installation Guides

Method 1: Installing VS Code via Snap (Simplest Approach)

Let's start with the easiest method that Ubuntu now promotes by default. I've used this approach for quick demonstrations and temporary setups, though it's not my primary choice for daily development work.

Pin

Step 1: Update your package list

sudo apt update

Step 2: Install VS Code Snap package

sudo snap install --classic code

The –classic flag is essential here—it disables security confinement, allowing VS Code to access your filesystem and function properly as a development tool.

Step 3: Launch and verify

code

Pros:

• Automatic updates handled seamlessly
• No dependency conflicts
• Isolated from system changes

Cons:

• Slightly slower startup time due to snap overhead
• File system access can sometimes feel restricted
• Theme integration with GNOME can be inconsistent

Method 2: Installing VS Code via Microsoft Repository (Recommended)

This is my go-to method for all my development machines. It provides the perfect balance of native performance, easy updates, and system integration. Here's my proven approach:

Step 1: Install prerequisite packages

sudo apt update
sudo apt install software-properties-common apt-transport-https wget

These packages ensure your system can properly handle external repositories and HTTPS connections.

Step 2: Import Microsoft's GPG key

sudo wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg

This cryptographic key verifies that the packages you're downloading are genuinely from Microsoft and haven't been tampered with.

Step 3: Add the VS Code repository

echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list

Step 4: Update and install VS Code

sudo apt update
sudo apt install code

The installation process typically takes 1-3 minutes depending on your internet connection and system speed.

Step 5: Verify the installation

code --version

This command should return version information, confirming that VS Code is properly installed and accessible from your terminal.

Why I prefer this method:

• Updates arrive simultaneously with Snap versions
• Native performance without container overhead
• Better integration with system themes and file managers
• Feels like a “first-class citizen” on the system

Method 3: Manual .deb Package Installation

While I don't recommend this for most users, there are scenarios where manual installation makes sense. Here's the safe approach:

Step 1: Download the latest .deb package

wget -O vscode.deb 'https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64'

Step 2: Install the downloaded package

sudo apt install ./vscode.deb

Step 3: Clean up the downloaded file

rm vscode.deb

Method 4: Flatpak Installation

For completeness, here's the Flatpak approach:

Step 1: Enable Flathub repository (if not already enabled)

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Step 2: Install VS Code

flatpak install flathub com.visualstudio.code

Post-Installation Optimization: Essential Configuration Steps

Installing VS Code is only half the battle. Here are the configurations I implement on every Ubuntu machine to optimize the development experience.

Fixing Terminal Integration

After installation, you might find that the code command doesn't work in your terminal. Here's the fix:

Step 1: Add VS Code to your PATH

echo 'export PATH="$PATH:/usr/share/code/bin"' >> ~/.bashrc

Step 2: Reload your bash configuration

source ~/.bashrc

Essential Extensions for Ubuntu Development

I've curated this extension list over years of Ubuntu development:

1. Remote – SSH: Essential for working with remote servers
2. Docker: Container management directly from VS Code
3. Python: Full-featured Python support with IntelliSense
4. GitLens: Enhanced Git capabilities
5. Bracket Pair Colorizer: Makes nested code more readable
6. Thunder Client: REST API client (excellent Postman alternative)

Install them using this command:

code --install-extension ms-vscode.remote-ssh --install-extension ms-azuretools.vscode-docker --install-extension ms-python.python

Performance Tweaks for Ubuntu

VS Code generally runs well on Ubuntu, but these settings in settings.json can improve responsiveness:

{
    "editor.renderLineHighlight": "gutter",
    "files.trimTrailingWhitespace": true,
    "editor.minimap.enabled": false,
    "editor.occurrencesHighlight": false,
    "editor.renderControlCharacters": true
}

Troubleshooting Common Installation Issues

Even with careful installation, you might encounter issues. Here are solutions to problems I've frequently encountered:

“code command not found” Error

If the code command isn't available after installation:

sudo ln -s /usr/share/code/bin/code /usr/local/bin/code

Permission Issues with Snap Installation

If VS Code can't access certain directories:

sudo snap connect code:home :home
sudo snap connect code:removable-media :removable-media

Repository Signature Errors

If you encounter GPG errors with the Microsoft repository:

sudo rm /etc/apt/sources.list.d/vscode.list
sudo rm /etc/apt/trusted.gpg.d/packages.microsoft.gpg
# Then restart from Method 2, Step 2

Performance Benchmarks: Real-World Testing

In my testing across multiple Ubuntu systems (20.04 LTS through 24.04 LTS), here's how the installation methods compare:

Key Takeaways: Installation Insights

Based on my extensive experience, here are the critical points to remember:

1. For most developers, the Microsoft repository method offers the best combination of performance, stability, and ease of maintenance.
2. Snap installations provide better isolation but may introduce minor performance penalties and integration quirks.
3. Manual .deb installations should be reserved for specific use cases where repository access isn't available.
4. Always verify your installation by checking the version and testing basic functionality before customizing your environment.
5. Post-installation configuration significantly impacts your long-term satisfaction with VS Code on Ubuntu.

Star Rating Summary

• Snap Installation

  • Ease of Installation: ★★★★★
  • Performance: ★★★☆☆
  • System Integration: ★★★☆☆
  • Update Reliability: ★★★★★
  • Overall: 4.0/5

• Microsoft Repository Installation

  • Ease of Installation: ★★★★☆
  • Performance: ★★★★★
  • System Integration: ★★★★★
  • Update Reliability: ★★★★★
  • Overall: 4.8/5

• Direct .deb Installation

  • Ease of Installation: ★★★☆☆
  • Performance: ★★★★★
  • System Integration: ★★★★★
  • Update Reliability: ★★☆☆☆
  • Overall: 3.5/5

• Flatpak Installation

  • Ease of Installation: ★★★★☆
  • Performance: ★★★☆☆
  • System Integration: ★★★☆☆
  • Update Reliability: ★★★★★
  • Overall: 3.8/5

Frequently Asked Questions (FAQs)

1. Which Ubuntu version works best with VS Code?

All currently supported Ubuntu LTS versions (20.04, 22.04, 24.04) work excellently with VS Code. I recommend using the latest LTS version for the best hardware support and performance features. The installation process is identical across these versions.

2. Can I run multiple installation methods simultaneously?

No, this will cause conflicts and unpredictable behavior. If you want to switch methods, completely remove the existing installation first using sudo apt remove code or sudo snap remove code, then proceed with your preferred method.

3. How do I safely upgrade VS Code?

For repository installations: sudo apt update && sudo apt upgrade. For Snap: updates are automatic. For manual .deb: download and install the new version. I recommend backing up your ~/.config/Code directory before major upgrades.

4. Why does the Snap version start slower?

The Snap package runs in a confined environment that must initialize various security and compatibility layers. This adds 0.8-1.5 seconds to startup time compared to native packages. For frequent restarts, this difference becomes noticeable.

5. How can I completely remove VS Code from Ubuntu?

For Snap: sudo snap remove code. For repository installation: sudo apt remove code && sudo apt autoremove. Also remove configuration files: rm -rf ~/.config/Code and rm -rf ~/.vscode.

My Recommended Approach After Years of Use

Having installed and configured VS Code on literally hundreds of Ubuntu systems over the past five years, I can confidently recommend the Microsoft repository method as the superior choice for most developers. While the Snap approach works adequately for casual users, the native performance and seamless system integration of the repository installation provide a noticeably better development experience.

The few extra minutes required to set up the Microsoft repository pay continuous dividends through faster startup times, more reliable file access, and better overall system harmony. This is the method I use for my own development workstations and the approach I recommend to my team and clients.

Remember that the best installation method is the one that fits your specific workflow and requirements. Whichever path you choose, you're gaining access to one of the most powerful and versatile code editors available today—a tool that has genuinely transformed how I work with Ubuntu systems.

Now that you're equipped with comprehensive installation knowledge, you can confidently set up VS Code and focus on what really matters: building amazing software.