package.json

package.json 是项目元数据、依赖与脚本的声明文件。字段的设计直接影响安装、发布与模块解析。

{
  "name": "@acme/service",
  "private": true,
  "type": "module",
  "packageManager": "pnpm@11.7.0",
  "engines": { "node": ">=24 <25" },
  "scripts": { "dev": "node --watch src/index.js", "test": "node --test" }
}

关键字段

• name、version：发布包的身份；私有应用应设 private: true 防止误发布。
• type：决定 .js 文件默认按 ESM 还是 CommonJS 解释。
• exports：声明包对外入口；库优先设置，避免内部文件成为隐式 API。
• bin：暴露 CLI 命令。
• files：发布白名单；结合 .npmignore 控制包内容。
• engines、packageManager：声明运行时与包管理器约束。
• scripts：统一开发、测试、构建和发布入口。

脚本中直接调用的本地依赖可从 node_modules/.bin 自动解析；不需要全局安装。