package.json 是 Node.js 项目的元信息与依赖配置核心文件，定义 name、version、description、main、type 等基础字段，dependencies 与 devDependencies 区分运行与开发依赖，scripts 支持自动化命令，engines、repository、license 等提升可维护性。
package.json 是 JavaScript 项目（尤其是基于 Node.js 的项目）的“身份证”和“说明书”，它是一个 JSON 格式的配置文件，用于描述项目的元信息、依赖关系、脚本命令等核心内容。没有它，npm（Node Package Manager）就无法正确安装依赖、运行脚本或发布包。
项目基础信息
这部分告诉别人“这是什么项目”。关键字段包括：
- name：包名，必须全小写、短横线分隔，不能有空格；发布到 npm 时需全局唯一
- version：遵循语义化版本（如 1.2.3），是发布和依赖锁定的基础
- description：简明介绍项目用途，会显示在 npm 官网和搜索结果中
- main：指定模块入口文件（如 index.js），require('your-package') 时实际加载的就是这个文件
- type：设为 "module" 表示项目使用 ES 模块语法（支持 import/export），否则默认为 CommonJS
依赖管理
明确区分不同场景下需要的包，避免生产环境误装开发工具：
- dependencies：项目运行时必需的包（如 lodash、axios），执行 npm install（无参数）时安装
- devDependencies：仅开发阶段需要的包（如 vite、eslint、@types/react），加 --save-dev 或 -D 安装
- peerDependencies：声明“我期望宿主环境提供什么”（常见于插件类库），比如 React 组件库可能写 "react": "^18.0.0"，提醒使用者自行安装兼容版本
- optionalDependencies：可选依赖，安装失败不会中断流程（如用 C++ 编写的加速模块 fallback 到 JS 实现）
脚本与自动化
scripts 字段把常用命令变成一键操作，大幅提升协作效率：
立即学习“Java免费学习笔记（深入）”；
- 预设脚本如 "start"、"test"、"build" 可直接用 npm start 运行
- 支持链式调用："build": "npm run clean && vite build"
- 可调用本地 node_modules/.bin 下的命令（如 eslint、prettier），无需全局安装
- 自定义脚本还能传参："deploy": "node deploy.js --env=prod"
其他实用字段
这些字段提升可维护性与规范性：
- engines：声明兼容的 Node.js 和 npm 版本（如 {"node": ">=18.0.0", "npm": ">=9.0.0"}），安装时会校验
- keywords：数组形式的标签，帮助 npm 搜索归类
-
author / contributors：作者与贡献者信息，格式为 "Name
(url)" - repository：指向 Git 仓库（如 GitHub），格式为 {"type": "git", "url": "https://github.com/xxx/yyy.git"}
- license：开源协议（如 "MIT"），影响项目合规使用
- types：TypeScript 项目中指定类型声明文件路径（如 "index.d.ts"）
