Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit ea9beb6

Browse filesBrowse 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
Copy full SHA for ea9beb6

1 file changed

+23-20Lines changed: 23 additions & 20 deletions

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎BUILDING.md‎

Copy file name to clipboardExpand all lines: BUILDING.md
+23-20Lines changed: 23 additions & 20 deletions
  • Display the source diff
  • Display the rich diff
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 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.