Как инициализировать проект Node.js с package.json и первым

Короткий ответ: создайте отдельную папку, выполните в ней npm init -y, добавьте файл index.js, пропишите команду запуска в package.json и проверьте проект через npm start

Инициализация проекта — это не установка Node.js. Node.js ставится один раз на компьютер, а проект создается в отдельной папке под конкретную задачу. В этой папке появляется package.json, список зависимостей, скрипты запуска и код приложения

Содержание

Создайте папку проекта
Инициализируйте package.json
Добавьте первый файл
Настройте npm start
Установите первую зависимость
Что добавить в .gitignore
Мини-практика
Частые ошибки
Что почитать дальше по Node.js

Создайте папку проекта

Откройте терминал и перейдите туда, где удобно хранить учебные проекты

mkdir first-node-project
cd first-node-project

Команда mkdir создает папку, а cd переводит терминал внутрь этой папки. Это важно: npm init должен выполняться не где попало, а именно внутри папки будущего проекта

Инициализируйте package.json

Выполните

npm init -y

После этого появится файл package.json. Он описывает проект: имя, версию, команды запуска, зависимости и служебную информацию

Минимальный package.json может выглядеть так

{
  "name": "first-node-project",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  }
}

Флаг -y означает “согласиться с настройками по умолчанию”. Без него npm будет задавать вопросы в терминале

Добавьте первый файл

Создайте index.js

console.log("Проект Node.js запущен");
console.log("Текущая версия:", process.version);

Запустите файл напрямую

node index.js

Если видите текст в консоли, проект уже работает

Настройте npm start

Откройте package.json и добавьте команду start

{
  "name": "first-node-project",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  }
}

Теперь проект можно запускать так

npm start

Для учебного проекта разницы немного, но для реальной разработки npm start удобнее: команда запуска хранится в самом проекте, и другой человек сразу понимает, как его открыть

Установите первую зависимость

Например, поставим dayjs для работы с датами

npm install dayjs

В package.json появится раздел dependencies, а рядом появятся node_modules и package-lock.json

Пример использования

const dayjs = require("dayjs");

console.log("Сегодня:", dayjs().format("YYYY-MM-DD"));

Запуск

npm start

Так вы проверяете не только Node.js, но и работу npm-зависимостей

Что добавить в .gitignore

Если проект будет храниться в Git, создайте .gitignore

node_modules/
.env

Папку node_modules обычно не сохраняют в репозиторий. Ее можно восстановить командой npm install, потому что список зависимостей уже записан в package.json и package-lock.json

Мини-практика

Создайте новый проект node-weather-demo, выполните npm init -y, добавьте index.js, настройте npm start и установите любую маленькую зависимость. После этого удалите папку node_modules и восстановите ее через npm install

Так становится понятно, зачем проекту нужны сразу три вещи: package.json, package-lock.json и node_modules

Частые ошибки

Выполнили npm init не в той папке Проверьте pwd на macOS/Linux или cd без аргументов в Windows PowerShell. package.json должен лежать в корне проекта

Удалили package-lock.json без понимания причины Этот файл фиксирует версии зависимостей. В обычном проекте его лучше оставлять

Пытаются отправить node_modules в Git node_modules может быть огромной папкой. Добавьте ее в .gitignore

Путают npm init и npm install npm init создает проект, а npm install ставит зависимости