@@ -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
769774NOTE: 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,
772777even 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