Skip to content

doc: support toolchain Visual Studio 2022 & 2026 + Windows 10 & 11 SDK#61864

Open
MikeMcC399 wants to merge 2 commits intonodejs:mainfrom
MikeMcC399:windows-supported-toolchain
Open

doc: support toolchain Visual Studio 2022 & 2026 + Windows 10 & 11 SDK#61864
MikeMcC399 wants to merge 2 commits intonodejs:mainfrom
MikeMcC399:windows-supported-toolchain

Conversation

@MikeMcC399
Copy link
Contributor

@MikeMcC399 MikeMcC399 commented Feb 17, 2026

Refs: #61449

Situation

The Supported toolchains section of the BUILDING.md document specifies:

Operating System Compiler Versions
Windows Visual Studio >= 2022 with the Windows 10 SDK on a 64-bit host
  1. The use of only a lower bound for the version of Visual Studio conflicts with the structure of the Windows vcbuild.bat. Each version of Visual Studio needs to be explicitly supported by the script, which currently includes the ability to work with Visual Studio 2022 and 2026 only. According to Visual Studio Product Lifecycle and Servicing it can be expected that Microsoft will release Visual Studio 2027 in November 2026 (See also https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-rhythm#annual-releases). The script will not automatically support this version and the statement of compatibility with "Visual Studio >= 2022" will become incorrect.
  2. As described in the Windows > Option 1: Manual install section of the BUILDING.md document, the "Desktop development with C++" workload is required. In the older Visual Studio 2019, this installed the Windows 10 SDK. The Visual Studio 2022 & 2026 releases however install the Windows 11 SDK, not the Windows 10 SDK by default, although Visual Studio 2022 does allow optionally installing the (out-of-support) Windows 10 SDK.

Change

Update the Supported toolchains section of the BUILDING.md document to:

Operating System Compiler Versions
Windows Visual Studio 2022 or 2026 with the Windows 10 or 11 SDK on a 64-bit host

This restricts the Visual Studio versions to the working ones, and adds Windows 11 SDK (which is the one currently supported by Microsoft) to the supported toolchain.

Backporting

@nodejs-github-bot
Copy link
Collaborator

Review requested:

  • @nodejs/build
  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations. labels Feb 17, 2026
@MikeMcC399 MikeMcC399 marked this pull request as ready for review February 17, 2026 11:05
@MikeMcC399

This comment was marked as resolved.

@MikeMcC399 MikeMcC399 changed the title doc: support toolchain Visual Studio 2022 & 2026 + Windows 11 SDK doc: support toolchain Visual Studio 2022 & 2026 + Windows 10 & 11 SDK Feb 18, 2026
@MikeMcC399
Copy link
Contributor Author

For the Windows SDK:

Note that the Windows 10 SDK (10.0.19041.0) is out of support since 2025-10-14.

  • Visual Studio 2022 (17.14.27) shows Windows 10 SDK as out of support.
  • Visual Studio 2026 (18.3.1) no longer offers Windows 10 SDK for installation.

The Windows 11 SDK "can target Windows 11, version 25H2, in addition to previous Windows releases."

Windows 10 SDK should be removed from the Node.js supported toolchain in a separate semver-major PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

Comments