如何发布NPM包_代码007(未授权)

本文介绍: 本文中完整的记录了NPM包发布的流程，如果你在日常开发过程中遇到能够复用、抽离与封装的功能模块，尝试将其贡献出来吧~

在日常开发过程中，我们经常使用引用一些第三方库来快速的进行项目开发，这得益于前端丰富的生态。

身为前端开发者的我们，可能也会遇到可复用、可抽离、可封装的模块，我们将其发布 NPM 包是一个很好的选择。

发布 NPM 包，需要先注册 NPM 官网 https://www.npmjs.com/ 的账号，仅需一个邮箱即可。

新建一个文件夹并打开终端初始化项目；

npm init -y

此时会自动生成 package.json 的配置文件，这里主要包含了项目名称、版本号、作者、许可证等信息，同时可以记录项目的依赖信息以及自定义的脚本。

{
  "name": "项目名",
  "version": "1.0.0",
  "description": "项目简介",
  "type": "module",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "files": ["dist"],
  "scripts": {
    "build": "rollup -c"
  },
  "keywords": [],
  "author": "不二博客 <buerblog@163.com>",
  "license": "ISC"
}

name 定义了项目的名称，它不可与现有的 NPM 名称重复；

version 定义了当前项目的版本号，每一次版本更新需大于当前版本；

license 定义了项目的许可证；

main 项目的入口文件，即第三方库默认导入的文件；

types 项目的类型定义文件；

files 定义了发布上传时包含的目录文件；

本文中我们使用 rollup 作为我们的打包工具，当然你也可以使用 vite、webpack、unbuild 等等，你可根据个人爱好进行选择。

yarn add rollup -D

当然编写一个完善的 NPM 包，我们应该使用 TypeScript 来编写。

yarn add typescript @rollup/plugin-typescript tslib -D

根目录下创建 rollup.config.js 配置文件，添加如下配置；

import typescript from '@rollup/plugin-typescript'

export default {
  input: 'src/index.ts',
  output: {
    name: '全局变量名称',
    file: 'dist/index.js',
    format: 'umd',
  },
  plugins: [typescript()],
}

在以上的配置中，input 定义了项目的入口文件、output 定义了项目的编译输出的配置；

name 在全局的作用域中生成当前项目的全局变量名称；

file 指定了输出文件的路径；

format 指定输入文件的格式，不同的配置作用于不同的运行环境；

更多配置可查看 Rollup 配置选项 https://cn.rollupjs.org/configuration-options/ 官方文档。

根目录下创建 tsconfig.json 配置文件，添加如下配置；

{
  "compilerOptions": {
    "target": "es2016",
    "module": "ESNext",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "moduleResolution": "node",
    "declaration": true,
    "outDir": "dist"
  }
}

moduleResolution 使用 Node.js 作为模块解析策略；

declaration 用于是否生成类型声明文件 （.d.ts 文件）；

outDir 用于配置编译文件的输出目录。

编写自己的库，在以下的示例中我们将 dayjs 进行导出；

yarn add dayjs

import dayjs from 'dayjs'

export default {
  dayjs,
}

rollup 是通过 rollup -c 的命令进行打包的，在前面的 package.json 配置中已经配置脚本命令，我们只需要运行如下命令即可。

yarn build

此时根据 rollup.config.js 和 tsconfig.json 配置，分别在 dist 文件夹内产出 index.js 和 index.d.ts 文件。

添加并登录 NPM 账户，如果是第一次登录执行如下命令，输入账号密码和邮箱进行登录；

npm login

如果你设置了第三方的镜像（淘宝源）的地址，此时我们需要切换为 NPM 官方的源；如果没有可以忽略这一步；

npm config set registry=https://registry.npmjs.org/

npm publish

等待上传成功后，我们可以在 NPM 里面可以查询到我们的 NPM 包，同时也可以引入到你的项目中使用；

npm install 项目名

本文中完整的记录了 NPM 包发布的流程，如果你在日常开发过程中遇到能够复用、抽离与封装的功能模块，尝试将其贡献出来吧~

显示所有内容

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。

npm 复用抽离

注册账号

创建 NPM 项目

打包工具

配置 Rollup

配置 TypeScript

编写库

打包

发布流程

总结

最后

发表回复取消回复