Skip to content

Commit ea9beb6

Browse files
MikeMcC399aduh95
authored andcommitted
doc: update to Visual Studio 2026 manual install
PR-URL: #61655 Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Stefan Stojanovic <stefan.stojanovic@janeasystems.com>
1 parent c851e76 commit ea9beb6

File tree

1 file changed

+23
-20
lines changed

1 file changed

+23
-20
lines changed

BUILDING.md

Lines changed: 23 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -657,14 +657,20 @@ Refs:
657657

658658
* The current [version of Python][Python downloads] by following the instructions in
659659
[Using Python on Windows][].
660-
* The "Desktop development with C++" workload from
661-
[Visual Studio 2022 (17.6 or newer)](https://visualstudio.microsoft.com/downloads/)
662-
or the "C++ build tools" workload from the
663-
[Build Tools](https://aka.ms/vs/17/release/vs_buildtools.exe),
664-
with the default optional components. As of Node.js 24.0.0, ClangCL is required to compile
665-
on Windows. To enable it, two additional components are needed:
660+
* Select and download the Visual Studio Community Edition 2026 from
661+
[Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/) or alternatively download
662+
[Build Tools for Visual Studio 2026](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2026),
663+
and then install.
664+
The Build Tools Edition has the lowest disk space requirements of all editions.
665+
Professional or Enterprise Editions can also be alternatively selected.
666+
* During installation of Visual Studio, select the "Desktop development with C++" workload.
667+
As of Node.js 24.0.0, ClangCL is required to compile on Windows.
668+
To install it, select the following two optional components:
666669
* C++ Clang Compiler for Windows (Microsoft.VisualStudio.Component.VC.Llvm.Clang)
667-
* MSBuild support for LLVM toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset)
670+
* MSBuild support for LLVM (clang-cl) toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset)
671+
* As an alternative to Visual Studio 2026, download Visual Studio 2022 Current channel Version 17.4 from the
672+
[Evergreen bootstrappers](https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history#evergreen-bootstrappers)
673+
table and install using the same workload and optional component selection as described above.
668674
* Basic Unix tools required for some tests,
669675
[Git for Windows](https://git-scm.com/download/win) includes Git Bash
670676
and tools which can be included in the global `PATH`.
@@ -673,26 +679,23 @@ Refs:
673679
to `PATH`. A build with the `openssl-no-asm` option does not need this, nor
674680
does a build targeting ARM64 Windows.
675681

676-
Optional requirements to build the MSI installer package:
682+
After you have installed any Visual Studio Edition you can add optional components using the
683+
Modify / Individual Components tab of Visual Studio Installer.
677684

678-
* The .NET SDK component from [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/)
679-
* This component can be installed via the Visual Studio Installer Application
685+
Optional component required to build the MSI installer package:
680686

681-
Optional requirements for compiling for Windows on ARM (ARM64):
687+
* The .NET SDK individual component (Microsoft.NetCore.Component.SDK)
682688

683-
* Visual Studio 17.6.0 or newer
684-
> **Note:** There is [a bug](https://github.com/nodejs/build/issues/3739) in `17.10.x`
685-
> preventing Node.js from compiling.
686-
* Visual Studio optional components
687-
* Visual C++ compilers and libraries for ARM64
688-
* Visual C++ ATL for ARM64
689-
* Windows 10 SDK 10.0.17763.0 or newer
689+
Optional components required to compile for Windows on ARM64:
690+
691+
* MSVC Build Tools for ARM64/ARM64EC (Microsoft.VisualStudio.Component.VC.Tools.ARM64)
692+
* C++ ATL for ARM64 (Microsoft.VisualStudio.Component.VC.ATL.ARM64)
690693

691694
NOTE: Currently we only support compiling with Clang that comes from Visual Studio.
692695

693-
When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed
696+
When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed,
694697
even when the Visual Studio Installer shows that they are installed, try removing the components
695-
first and then reinstalling them again.
698+
first and then reinstalling them.
696699

697700
##### Option 2: Automated install with WinGet
698701

0 commit comments

Comments
 (0)