Codebook
Light mode Dark mode

VS Code Native Tabs Support

November 14, 2025
Published in Development Tools

Abstract

Visual Studio Code offers the capability to merge multiple windows into native system-level tabs, though this feature's availability and implementation vary significantly across different operating systems. Understanding these platform-specific differences can enhance your workflow and help you leverage VS Code's full potential.

Keywords: VS Code, macOS, Linux, IDE Configuration

macOS Native Tab Support

macOS users benefit from comprehensive native tab support, enabling multiple VS Code windows to be consolidated within a single parent window, similar to the tab experience in web browsers like Chrome.

Configuration Steps

  1. Navigate to "System Preferences" → "Desktop & Dock" → "Prefer tabs when opening documents" and set it to "Always"
  2. In VS Code settings, search for and enable window.nativeTabs
  3. Restart VS Code to apply the changes

Once configured, multiple VS Code windows will merge into native tabs within the same parent window. A native tab bar appears at the top of the window, providing seamless navigation between different projects or workspaces. This integration takes advantage of macOS's built-in window management capabilities, offering a polished and familiar user experience.

Windows and Linux Limitations

In contrast to macOS, Windows and Linux users face limitations regarding native window-level tab support.

Current Capabilities

  • VS Code does not officially support merging separate project windows into native tabs on Windows or Linux platforms
  • Opening multiple files within a single workspace automatically displays them as "editor tabs" within that window
  • Tab display and switching can be managed through the workbench.editor.showTabs setting
  • Multi-window switching relies on the operating system's native window management features rather than VS Code's integrated tab system

Alternative Workflows

Whilst native window-level tabs are unavailable, users can still work efficiently with multiple projects by:

  • Utilising OS-specific window management shortcuts (Alt+Tab on Windows, Alt+Tab or Super+Tab on Linux)
  • Opening multiple files within workspaces, which are displayed as editor tabs
  • Leveraging VS Code's workspace feature to group related folders