package.json 的核心是 name 和 version 字段,必须符合 npm 规范;scripts 定义命令,dependencies/devDependencies 区分运行与开发依赖;main/module/exports 控制模块入口,types 提供类型定义;private、engines、browserslist 等提升环境一致性。

直接在 package.json 里写配置,JavaScript 本身不“配置”它——但你可以用 JS 脚本动态生成、读取或修改它,常见于构建流程、CI/CD 或初始化工具中。真正起作用的是 package.json 文件本身的 JSON 结构,Node.js 和 npm/yarn/pnpm 都按规范解析它。
必填字段:name 和 version
这是发布到 npm 的硬性要求,哪怕本地开发也建议保留:
- name:包名,小写字母、短横线、下划线组成,不能含空格;若发布,需在 npm 上未被占用
-
version:遵循 SemVer 2.0(如
"1.2.3"),npm 安装、升级、依赖解析都依赖它
核心功能字段:scripts 和 dependencies
这两个字段决定项目怎么跑、依赖怎么装:
-
scripts:定义可执行命令,比如
"start": "node index.js",运行时用npm start;支持组合("build": "tsc && vite build")和钩子(prebuild/postbuild) -
dependencies:生产环境必须的包,安装时加
--save(npm v5+ 默认行为);上线时会被打包或 require,删掉会导致运行时报错 -
devDependencies:仅开发时需要,如
typescript、vite、eslint;上线一般不包含,减小部署体积
模块与入口字段:main、module、exports 和 types
影响其他项目如何引入你的代码:
标签: javascript java js 前端 node.js json node vite typescript npm
还木有评论哦,快来抢沙发吧~