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 they do allow optionally installing the Windows 10 SDK.
  3. Windows 10 Home & Pro reached end-of-life on Oct 14, 2025. Windows 10 Enterprise LTSC 2019 has a future end-of-life on Jan 9, 2029. Windows 10 LTSC states:

    The Long-Term Servicing Channel (LTSC) is designed to be used only for specialized devices - for example, those that control medical equipment or automated teller machines (ATMs).

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

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
Copy link
Contributor Author

I corrected a typo in the OP.

Visual Studio 2026 was released in Nov 2025
Visual Studio 2027 is therefore expected in Nov 2026 (not 2027 as I originally wrote)

See https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-rhythm#annual-releases

@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
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