Fix Windows Build Tools Errors for Node.js Native Modules

After reading this article, your Windows build skills may increase—mastering the installation of various Windows build tools.

Basic Concepts

Windows Build Tools : tools used to compile native C++ modules for Node.js into binaries recognized by Node.

node-gyp : a cross‑platform CLI for compiling Node.js native addons; on Windows it relies on Windows Build Tools.

node-pty : the npm package used in this article as an example; it requires node‑gyp to compile its native component.

Troubleshooting

Many users encounter errors when compiling native Node.js modules. Previously one could run

npm install -g windows-build-tools

and then install Python 2.7 or 3.9 to get the required compilers.

Recently the same command no longer works, showing an “administrator permission required” message even when the console is run as admin.

The official windows‑build‑tools package is no longer maintained.

Using the official Node.js installer and checking the “Automatically install the necessary tools” option installs Python and the C++ build tools.

When trying to install

node-pty

in an empty directory, the output is garbled because the console uses GB2312 encoding. Switching to UTF‑8 with

chcp 65001

makes the text readable.

The error “cannot create type. This language mode only supports core types” is caused by PowerShell running in ConstrainedLanguage mode. Running

$ExecutionContext.SessionState.LanguageMode

shows “ConstrainedLanguage”. Changing it to “FullLanguage” fails, but the registry key

__PSLockdownPolicy

can be set to 8 to enable FullLanguage.

After adjusting the registry, the build tools can be re‑installed. Installing Visual Studio 2019 Build Tools manually (download from the Visual Studio website, select “C++ desktop development”) still results in “could not find a version of Visual Studio 2017 or newer” because node‑gyp looks for the wrong path.

The problematic path is the

VCINSTALLDIR

environment variable. It should point to

C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild

instead of the parent folder.

After correcting the environment variable and running

npm config set msvs_version 2019

, the installation succeeds.

Summary

Two reliable ways to install Windows build tools:

Solution 1

Use the Node.js installer (https://nodejs.org) and enable “Automatically install the necessary tools”, which installs Python and the required C++ build tools.

Solution 2

Download “Visual Studio 2019 Build Tools” from https://visualstudio.microsoft.com/zh-hans/downloads.

Select “C++ desktop development” during installation.

Restart the command prompt.

If the command line cannot find version 2019, set the

VCINSTALLDIR

environment variable to

C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild

.

Run

npm config set msvs_version 2019

(verify with

npm config list

).

After these steps, native packages should install correctly.

References

PowerShell Constrained Language Mode blog: https://devblogs.microsoft.com/powershell/powershell-constrained-language-mode

Visual Studio download page: https://visualstudio.microsoft.com/zh-hans/downloads