re:re:actable
Урок 022 минуты чтения

Что такое package.json?

На этой странице
Кратко

package.json - главный манифест Node.js-проекта. В нем описывают имя пакета, версию, scripts, зависимости, тип модулей, entry points и настройки инструментов.

Вопрос

Что такое package.json и какие поля в нем самые важные?

Главное

{
  "name": "api-server",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "node --watch src/index.js",
    "test": "node --test"
  },
  "dependencies": {
    "express": "^5.0.0"
  },
  "devDependencies": {
    "eslint": "^9.0.0"
  }
}

Важные поля

ПолеЗачем нужно
nameИмя проекта или пакета
versionВерсия
typeCommonJS или ESM для .js
scriptsКоманды проекта
dependenciesProduction-зависимости
devDependenciesИнструменты разработки
mainГлавная точка входа
exportsСовременное описание публичных entry points
enginesТребуемые версии Node/npm

scripts

npm run dev
npm test

scripts позволяют стандартизировать команды команды и CI.

type

{
  "type": "module"
}

Это поле влияет на то, как Node.js интерпретирует .js файлы: как ESM или CommonJS.

Что важно помнить

  • Ключевые поля: name, version, type, scripts, dependencies, devDependencies, exports, engines.
  • "private": true защищает приложение от случайной публикации в npm.
  • Версии зависимостей задают по semver: ^1.2.3 разрешает minor и patch, ~1.2.3 — только patch.
  • Точные установленные версии фиксирует lockfile, а не package.json.

Мини-шпаргалка

  • package.json - манифест проекта.
  • scripts задают команды.
  • dependencies нужны в runtime.
  • devDependencies нужны для разработки.
  • "type": "module" включает ESM для .js.
  • engines помогает фиксировать версию Node.js.

Документация

npm: package.json, Node.js: Packages.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам