package.json 是项目的“身份证”:声明名称、版本、依赖与"> package.json 是项目的“身份证”:声明名称、版本、依赖与"> package.json 是项目的“身份证”:声明名称、版本、依赖与">
前端工程化 词条目录
前端Wiki/前端工程化/基础/包管理器

npm 与 package.json

npm 是 Node.js 内置的包管理器,package.json 是项目的“身份证”:声明名称、版本、依赖与可执行脚本。几乎所有前端工具链(vite、eslint、vitest)都通过 npm 安装与分发。

最常用的命令只有几个:npm install 装依赖、npm install <pkg> 装单个包、npm run dev 跑 scripts 里定义的命令、npx <cmd> 临时执行一个包(不必全局安装)。

  • scripts 字段是命令入口:npm run xxx 实际执行的是里面的 shell 命令
  • dependencies 是运行时依赖,devDependencies 是开发时依赖(打包不进产物)
  • --save-dev / -D 装到 devDependencies;不加默认装到 dependencies
配置
// package.json 核心字段
{
  "name": "shop-admin",          // 项目名(发布 npm 时唯一)
  "version": "1.2.0",            // 语义化版本:主版本.次版本.修订号
  "type": "module",              // 项目内 .js 全部按 ESM 解析
  "main": "dist/index.js",       // 别人 import 时的入口
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "lint": "eslint . --fix"
  },
  "dependencies": {
    "vue": "^3.4.21",            // 运行时需要
    "axios": "^1.6.8"
  },
  "devDependencies": {
    "vite": "^5.2.0",            // 只在开发/构建时需要
    "eslint": "^8.57.0"
  }
}
本节要点package.json 是项目身份证:scripts 定义命令,两类依赖区分运行时与开发时。