.CODE-WORKSPACE File Extension

Microsoft Visual Studio Code Multi-root Workspace

Developer Microsoft
4.0  |  2 Votes

What is a CODE-WORKSPACE file?

A CODE-WORKSPACE file is a multi-root workspace created in Microsoft Visual Studio Code. It contains references to the root folders included in a Visual Studio Code workspace. CODE-WORKSPACE files are created by selecting File → Save Workspace As... from Visual Studio Code's menu bar.

More Information

Screenshot of a .code-workspace file in Microsoft Visual Studio Code
CODE-WORKSPACE file open in Microsoft Visual Studio Code

Microsoft Visual Studio Code (VS Code) is an open source, cross-platform code editor that developers can use to develop and debug applications. When developers want to work on multiple, related projects in VS Code at the same time, they can group those projects into a multi-root workspace. Doing so allows developers to open and switch between related projects using VS Code's EXPLORER sidebar, rather than opening each project in a separate instance of VS Code.

For example, a developer who wants to simultaneously open and edit an app's source code and its documentation can add both projects to a multi-root workspace. Then, as the developer updates the app's source code, they can update the app's documentation to reflect those code changes.

When a user saves a multi-root workspace (by selecting File → Save Workspace As... from VS Code's menu bar), the workspace is saved as a CODE-WORKSPACE file. This file is a JSON file that contains a list of the root directories the workspace includes. When a user loads a workspace, VS Code uses these references to determine which folders to show in the EXPLORER sidebar.

How do I add a folder to a Visual Studio Code workspace?

To add a folder to a Visual Studio Code workspace:

  1. Select File > Add Folder to Workspace... from Visual Studio Code's menu bar.
  2. In the window that appears, navigate to the folder you want to add and select Add.

The folder will then be added to your Visual Studio Code workspace.

How to open a CODE-WORKSPACE file

You can use a CODE-WORKSPACE file to open a multi-root workspace in Microsoft Visual Studio Code (cross-platform). To do so:

  1. Select File → Open Workspace... from VS Code's menu bar.
  2. Select and Open your CODE-WORKSPACE file.

The folders your CODE-WORKSPACE file references will then appear in VS Code's EXPLORER sidebar.

If you want to view the JSON-formatted text a CODE-WORKSPACE file contains, you can open the file in any text editor. You may want to do this, for example, if VS Code fails to open your CODE-WORKSPACE file.

Open over 400 file formats with File Viewer Plus.Free Download

Programs that open CODE-WORKSPACE files

Verified by FileInfo.com

The FileInfo.com team has independently researched the Microsoft Visual Studio Code Multi-root Workspace file format and Mac, Windows, and Linux apps listed on this page. Our goal is 100% accuracy and we only publish information about file types that we have verified.

If you would like to suggest any additions or updates to this page, please let us know.