Инструменты

Node.js — это среда выполнения, которая выполняет JavaScript на вашей машине. Она объединяет JavaScript-движок V8 с набором встроенных модулей, позволяющих запускать JavaScript вне браузера.

Скачайте подходящий для вашей платформы установщик со страницы загрузок Node.js. Релиз LTS (Long Term Support) — самый стабильный выбор и рекомендуется для разработки аддонов. Установщик включает npm.

Node-API стабилен во всех поддерживаемых в настоящее время релизах Node.js. Подойдёт любой релиз Active LTS или Maintenance LTS.

npm — менеджер пакетов для Node.js. Он устанавливается вместе с Node.js. Для большинства разработчиков на Node-API цель — опубликовать npm-пакет, который оборачивает C/C++-библиотеку и делает её доступной JavaScript-пользователям.

npm входит в комплект Node.js. Поддерживать его в актуальном состоянии можно так:

npm install -g npm@latest

Git не является строго обязательным для работы с Node-API, но используется во всей экосистеме. Большинство примеров-репозиториев и установок зависимостей полагаются на него.

Помимо Node и npm, вам нужны C/C++-тулчейн компилятора и Python (требуется node-gyp).

Рекомендуемый подход — установить Visual Studio Build Tools с выбранной нагрузкой (workload) «Desktop development with C++». Это даёт компилятор MSVC, Windows SDK и инфраструктуру сборки, которую требует node-gyp.

Как вариант, можно установить через winget:

winget install Microsoft.VisualStudio.2022.BuildTools

Во время или после установки откройте Visual Studio Installer и убедитесь, что нагрузка «Desktop development with C++» отмечена.

Также требуется Python 3. Установите его с python.org или через winget:

winget install Python.Python.3

Запускайте PowerShell или cmd.exe от имени администратора при установке глобальных инструментов.

Установите command-line developer tools от Apple. Если вы ещё не установили Xcode, самый быстрый путь:

xcode-select --install

Если это не сработает, установите полную IDE Xcode из Mac App Store, которая включает необходимый тулчейн компилятора.

Python 3 не входит в комплект современных macOS. Установите его с помощью Homebrew:

brew install python3

Или скачайте установщик с python.org.

На большинстве дистрибутивов Linux нужные C/C++-тулчейн и Python либо предустановлены, либо легко добавляются. Для систем на базе Debian/Ubuntu:

sudo apt-get update
sudo apt-get install -y build-essential python3

Для других дистрибутивов обратитесь к документации вашего менеджера пакетов или к руководству по установке LLVM.

После установки убедитесь, что каждый инструмент есть в вашем PATH.

node --version
npm --version
python3 --version
git --version
cc --version
make --version

node --version
npm --version
python --version
git --version

Чтобы подтвердить, что компилятор MSVC доступен, откройте Developer Command Prompt (устанавливается вместе с Visual Studio Build Tools) и выполните:

cl

Вам понадобится шелл — Terminal на macOS/Linux, PowerShell или Windows Terminal на Windows.

Настоятельно рекомендуется хороший редактор кода. У Visual Studio Code отличная поддержка C/C++ через расширение C/C++, и он хорошо интегрируется со сборками node-gyp. CLion — ещё один популярный выбор для разработки на C++.