1. Open Visual Studio Code: Launch Visual Studio Code.
2. Close any open folder or workspace: If you have an existing folder or workspace open, close it by going to File > Close Folder or File > Close Workspace.
3. Create an empty workspace: Go to File > Save Workspace As…. This will open a save dialog.
4. Choose a location and name: Select a location on your file system where you want to save the workspace file. Give your workspace a descriptive name (e.g., my-complex-project.code-workspace). Visual Studio Code will save a file with the .code-workspace extension.
5. Add folders to the workspace: Once the empty workspace is created, you’ll see an empty Explorer pane. To add folders, click on File > Add Folder to Workspace….
6. Select folders: In the file dialog, navigate to and select the folders you want to include in your multi-root workspace. You can select multiple folders from different locations. Click Add.
7. Save the workspace (if not already saved): If you haven’t saved the workspace yet, or if you’ve made changes, go to File > Save Workspace to save the current workspace configuration.

Anatomy of a .code-workspace

{
	"folders": [
		{
			"path": "path/to/folder1"
		},
		{
			"path": "path/to/folder2",
			"name": "Custom Folder Name"
		},
		{
			"uri": "git://repo-url?ref#folder-in-repo",
			"name": "Remote Repository Folder"
		}
	],
	"settings": {
		"editor.tabSize": 2,
		"files.autoSave": "afterDelay"
	},
	"extensions": {
		"recommendations": ["ms-vscode.vscode-typescript", "dbaeumer.vscode-eslint"]
	}
}

When we get into tasks and debugging, we’ll see that you can also define them in the .code-workspace as well.