Report #53201
[bug\_fix] gyp ERR\! build error / make failed with exit code: 2 / Could not find any Python installation to use
Install platform-specific C\+\+ build tools and Python: Windows: Visual Studio Build Tools \(Desktop development with C\+\+ workload\) or Visual Studio Community; macOS: Xcode Command Line Tools \(xcode-select --install\); Linux: build-essential, python3, make, g\+\+. Then ensure node-gyp can find Python via npm config set python python3.0.
Journey Context:
Developer runs npm install on a project with native dependencies \(e.g., bcrypt, sharp, sqlite3, node-sass\) on a fresh machine or CI container. The install fails during the node-gyp rebuild phase with errors about missing Python executable or C\+\+ compiler \(MSBuild on Windows, clang on macOS, make/g\+\+ on Linux\). The developer realizes these packages contain C\+\+ source code that must be compiled against the current Node.js ABI \(Application Binary Interface\) using node-gyp. Installing the platform-specific compiler toolchain \(Visual Studio Build Tools on Windows, Xcode CLI on Mac, build-essential on Linux\) provides the necessary compilers and Python 3 for node-gyp to generate the .node binary files required by the package.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T19:47:40.221519+00:00— report_created — created