Skip to content

Commit 513df82

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 7fb7030 commit 513df82

File tree

1 file changed

+23
-18
lines changed

1 file changed

+23
-18
lines changed

BUILDING.md

Lines changed: 23 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -737,14 +737,20 @@ Refs:
737737

738738
* The current [version of Python][Python downloads] by following the instructions in
739739
[Using Python on Windows][].
740-
* The "Desktop development with C++" workload from
741-
[Visual Studio 2022 (17.13 or newer)](https://visualstudio.microsoft.com/downloads/)
742-
or the "C++ build tools" workload from the
743-
[Build Tools](https://aka.ms/vs/17/release/vs_buildtools.exe),
744-
with the default optional components. As of Node.js 24.0.0, ClangCL is required to compile
745-
on Windows. To enable it, two additional components are needed:
740+
* Select and download the Visual Studio Community Edition 2026 from
741+
[Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/) or alternatively download
742+
[Build Tools for Visual Studio 2026](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2026),
743+
and then install.
744+
The Build Tools Edition has the lowest disk space requirements of all editions.
745+
Professional or Enterprise Editions can also be alternatively selected.
746+
* During installation of Visual Studio, select the "Desktop development with C++" workload.
747+
As of Node.js 24.0.0, ClangCL is required to compile on Windows.
748+
To install it, select the following two optional components:
746749
* C++ Clang Compiler for Windows (Microsoft.VisualStudio.Component.VC.Llvm.Clang)
747-
* MSBuild support for LLVM toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset)
750+
* MSBuild support for LLVM (clang-cl) toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset)
751+
* As an alternative to Visual Studio 2026, download Visual Studio 2022 Current channel Version 17.4 from the
752+
[Evergreen bootstrappers](https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history#evergreen-bootstrappers)
753+
table and install using the same workload and optional component selection as described above.
748754
* Basic Unix tools required for some tests,
749755
[Git for Windows](https://git-scm.com/download/win) includes Git Bash
750756
and tools which can be included in the global `PATH`.
@@ -753,24 +759,23 @@ Refs:
753759
to `PATH`. A build with the `openssl-no-asm` option does not need this, nor
754760
does a build targeting ARM64 Windows.
755761

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

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

761-
Optional requirements for compiling for Windows on ARM (ARM64):
767+
* The .NET SDK individual component (Microsoft.NetCore.Component.SDK)
762768

763-
* Visual Studio 17.13.0 or newer
764-
* Visual Studio optional components
765-
* Visual C++ compilers and libraries for ARM64
766-
* Visual C++ ATL for ARM64
767-
* Windows 10 SDK 10.0.17763.0 or newer
769+
Optional components required to compile for Windows on ARM64:
770+
771+
* MSVC Build Tools for ARM64/ARM64EC (Microsoft.VisualStudio.Component.VC.Tools.ARM64)
772+
* C++ ATL for ARM64 (Microsoft.VisualStudio.Component.VC.ATL.ARM64)
768773

769774
NOTE: Currently we only support compiling with Clang that comes from Visual Studio.
770775

771-
When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed
776+
When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed,
772777
even when the Visual Studio Installer shows that they are installed, try removing the components
773-
first and then reinstalling them again.
778+
first and then reinstalling them.
774779

775780
##### Option 2: Automated install with WinGet
776781

0 commit comments

Comments
 (0)