package.json 是一个用于描述和配置项目的重要文件,其中包含了许多字段和选项,可以影响项目的构建、依赖管理、脚本执行等方面。了解这些字段可以帮助开发者更好地理解和控制项目的行为。
package.json对于大部分前端开发者来说,知道dependencies与devDependencies就够了。但对于库开发者或有更高级需求的开发者来说,了解 package.json 的其他字段是非常有必要的。
本文介绍的字段分为官方字段与非官方字段。非官方字段是被主流打包工具(webpack,Rollup)所支持, 旨在提供更高级的配置和功能,以满足特定的构建需求,可能不具备通用性。
目前版本:v7.24.2
定义项目的名称,不能以"."和"_"开头,不能包含大写字母
定义项目的版本号,格式为:大版本号.次版本号.修订号
项目描述
项目关键词
项目作者
项目贡献者
项目主页地址
项目代码仓库地址
项目提交问题的地址
指定项目的资金支持方式和链接
生产环境的依赖包
如果不使用脱字符(^),安装的版本号固定;如果使用,则能安装当前大版本的最新版本,在package-lock.json中可查看当前实际安装的版本。
开发环境的依赖包,例如webpack、vite、babel、ESLint等。
对等依赖的作用:
示例:声明要使用组件库,需在项目中安装大于17.0.1版本的react
将对等依赖标记为可选,如果用户没有安装对等依赖,npm不会发出警告
声明捆绑依赖项(使用情景较少)
声明可选依赖项(使用情景较少)
声明对npm或node的版本要求
目前对NPM来说,engines只是起一个说明的作用,即使用户安装的版本不符合要求,也不影响依赖包的安装。但使用pnpm 和 yarn安装,如果版本不符合要求会导致安装失败。
单个代码库中统一管理多个包(monorepo),在workspaces声明目录下的package会软链到根目录的node_modules中。
表示所有子包都在packages文件夹下
在node_modules/.package-lock.json中可以看到 "link": true 链接符号信息
安装,卸载等命令都是一样的,只是多了"--workspace="参数(简写-w),用来指定在哪个包中执行命令
workspaces功能与lerna类似,如果只需简单地管理多个包,workspaces足够了。lerna具有版本管理,发包提示,简化多包项目发布流程等更多功能。
脚本入口
用于定义项目的配置项,例如设置环境变量
运行 npm run start,终端打印出 example.com
指定 ES 模块入口文件
示例:当其他开发者在他们的项目中导入你的包时,会加载并执行包中的dist/index.esm.js
指定 CommonJS 模块或 ES 模块入口文件。如果不指定该字段,默认是根目录下的index.js
提示:从 Node.js 12.20.0 版本开始,"main" 字段也可以指定 ES 模块的入口文件
指定浏览器使用的入口文件,例如umd模块。
指定 TypeScript 类型声明文件(.d.ts 文件)的路径
当打包工具支持exports字段时(webpack、Rollup 等),以上main,browser,module,types四个字段都被忽略
"." 表示默认导出
"import": 指定了 ES module (ESM) 规范下的导出文件路径
"require": 指定了 CommonJS 规范下的导出文件路径
"browser": 指定了用于浏览器环境的导出文件路径
"types": 指定了类型声明文件的路径
导出其他文件,例如除了导出默认路径,导出源文件
其他项目中使用
指定模块系统的使用方式,"commonjs","module","umd","json"
示例:指定模块系统为ES module模式,使用CommonJS文件时,需显式的定义为 .cjs 文件扩展名,来明确指定这些文件为 CommonJS 模块
指定哪些包被推送到npm服务器中
示例:只推送index.js和dist包到npm服务器
可以在项目根目录新建一个.npmignore文件,说明不需要提交到npm服务器的文件,类似.gitignore。写在这个文件中的文件即便被写在files属性里也会被排除在外
定义在全局安装时可执行的命令,例如构建脚手架
Linux 中的帮助指令(使用情景较少)
定义项目目录结构的字段(使用情景较少)
防止私有包发布到npm服务器,要发布到npm上设为false
当设置 "preferGlobal" 字段为 true 时,它表示你的包更适合以全局方式安装,而不是作为项目的依赖项进行本地安装。
这个字段的设置是为了向用户传达关于你的包的最佳使用方式的建议。它并不会直接影响包的安装方式或包管理器的行为。
在发布包时指定特定的配置
示例:指定包发布的注册表 URL,指定所有用户都可以访问(私有的会收费)
指定你的包适用的操作系统
示例:包只适用于darwin(macOS)和 linux
示例:禁用win32
该配置和OS配置类似,用CPU可以更准确的限制用户的安装环境
指定软件的开源协议:
ISC:在所有副本中保留版权声明和许可证声明,使用者就可以拿你的代码做任何想做的事情,你也无需承担任何责任
MIT:在所有副本或主要部分中保留版权声明和许可证声明,使用者就可以拿你的代码做任何想做的事情,你也无需承担任何责任
开源协议查询地址:opensource.org/licenses/
eslint的配置,更推荐新建 .eslintrc 进行配置
使用参考:新建 .eslintrc
babel的配置,更推荐新建 .babelrc 进行配置
unpkg 是一个基于 CDN 的前端包托管服务,用于在浏览器中直接引用和加载 npm 上发布的包。
无需下载,直接通过
本站资料均由网友自行发布提供,仅用于学习交流。如有版权问题,请与我联系,QQ:4156828
© CopyRight 2008-2024 All Rights Reserved. Powered By bs178.com 闽ICP备11008920号-3
闽公网安备35020302034844号