Workspace settings

The workspace configuration controls which DSC files, build defines, and package paths the extension uses when parsing your EDK2 project.

Configuration UI

The easiest way to manage the workspace settings is through the graphical configuration panel. Open it from the Workspace view title bar ($(gear) icon) or via the command palette:

> EDK2: Workspace configuration (UI)

Workspace settings UI

The panel lets you set:

  • DSC paths — the main .dsc files for your platform (relative to the workspace root).
  • Build Defines — definitions injected in your build command with -D (e.g. ARCH=X64).
  • Package paths — additional package roots passed to the EDK2 build.

Configuration file

The settings are stored in .edkCode/edk2_workspace_properties.json inside your workspace. You can also edit this file directly or open it with:

> EDK2: Workspace configuration (JSON)
{
    "packagePaths": [],
    "dscPaths": [
        "OvmfPkg\\OvmfPkgX64.dsc"
    ],
    "buildDefines": [
        "ARCH=X64"
    ]
}

dscPaths — Each entry should be a main DSC file used for compilation.

buildDefines — Definitions injected in your build command with -D. Add or modify entries to match your build.

After any modification to this file, VS Code will prompt you to reload the index.