node文件如何寫成npm包并發布出去

這篇文章主要介紹了node文件如何寫成npm包并發布出去，具有一定借鑒價值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

把node文件拷貝寫成npm包，并發布

npm插件發布

發布npm其實是一件很簡單的事情，只是因為長時間不發布會忘記，又得上網去查一下，所以就寫篇文章記錄一下。

新建文件目錄

• 新建目錄，取名任意

• 運行命令生成package.json

npm init --yes

安裝依賴

如果項目中還需要其他依賴，可以向正常開發時一樣通過npm install xxx安裝 不過這里有一點需要注意的是，-S、--save和--save-dev的區別，因為通常在開發項目的時候這三個是沒有什么本質區別的，但是在開發npm包的還是有區別的

• -S和--save下載的插件會被寫入dependencies,并且我們在安裝自定義的插件時，會一塊被下載

• --save-dev下載的插件會被寫入devDendencies，這個只是在開發的時候使用，并不會隨著自定義插件一塊被安裝

完善package.json

有幾個重要的信息是一定要填寫的

• name 別人安裝這個插件需要通過 npm install xxx,來安裝這個xxx對應的是name的value

• version 插件的版本，每次重新發布都需要重新這個版本后，不然發布會失敗

• main 入口文件

其他可以看需要填寫

{
"name": "node-fs-copy", //發布的包名，默認是上級文件夾名。不得與現在npm中的包名重復。包名不能有大寫字母/空格/下滑線!
  "version": "1.0.0",//你這個包的版本，默認是1.0.0。對于npm包的版本號有著一系列的規則，模塊的版本號采用X.Y.Z的格式，具體體現為：
  1、修復bug，小改動，增加z。
  2、增加新特性，可向后兼容，增加y
  3、有很大的改動，無法向下兼容,增加x
  "description": "",
  "main": "index.js",//入口文件，默認是Index.js，可以修改成自己的文件,這個很重要，當你在實際項目使用的時候，let a = require("包名")，它就去會去找對應的文件路徑哦。
  "scripts": {                  // 快捷命令，在package.json同目錄下輸入命令 npm run 鍵 就會執行 相對應的命令
    "bulid": "npx webpack --config myConfig.js"  //例如 輸入 npm run bulid 就會執行npx webpack --config myConfig.js的命令 。
  },
  "keywords": [ // npm搜索的關鍵字
     "node",
     "fs",
     "copy"
  ],
  "publishConfig": {
    "registry": "" // 發布的npm地址
  },
  "repository": {
      "type": "git",
      "url": "git+https://github.com/xxxx" // 代碼的git地址
  },
  "author": "zxw",
  "license": "ISC",//這個直接回車，開源文件協議吧，也可以是MIT，看需要吧。
  "dependencies": {             // 生產環境所依賴的包
    "jquery": "^3.4.1",
    "sea": "^1.0.2"
  },
  "devDependencies": {          // 開發環境所依賴的包
    "webpack": "^4.41.6"
  }
}

確定入口文件為index.js之后，并寫入代碼,注意引入和導出都需要通過node的方式

• index.js

const { exists, copyDir} = require('./lib/copy')

const fsCopy = (sourcePath, deptPath)=> {
  exists(sourcePath,deptPath, copyDir)
}

module.exports = {
  fsCopy
}

• /lib/copy.js

const fs = require('fs')

/**
 * 復制一個文件夾下的文件到另一個文件夾
 * @param src 源文件夾，即需要寫出的文件
 * @param dst 目標文件夾，需要寫入的文件
 */
const copyDir = function (src, dst) {
  // 讀取目錄中的所有文件/目錄
  fs.readdir(src, function (err, paths) {
    if (err) {
      throw err
    }
    paths.forEach(function (path) {
      const _src = src + '/' + path
      const _dst = dst + '/' + path
      let readable;
      let writable
      fs.stat(_src, function (err, st) {
        if (err) {
          throw err
        }
        // 判斷是否為文件
        if (st.isFile()) {
          // 創建讀取流
          readable = fs.createReadStream(_src)
          // 創建寫入流
          writable = fs.createWriteStream(_dst)
          // 通過管道來傳輸流
          readable.pipe(writable)
        }
        // 如果是目錄則遞歸調用自身
        else if (st.isDirectory()) {
          exists(_src, _dst, copyDir)
        }
      })
    })
  })
}
/*
* 判斷當前目標文件是否存在
* 如若不存在需要先進行創建
* */
const exists = function (src, dst, callback) {
  // 如果路徑存在，則返回 true，否則返回 false。
  if (fs.existsSync(dst)) {
    callback(src, dst)
  } else {
    fs.mkdir(dst, function () {
      callback(src, dst)
    })
  }
}

module.exports = {
  exists,
  copyDir
}

測試

這一塊我只是進行了比較簡單的測試，后續我會專門補一章關于插件測試的文章

發布

• 注冊npm賬號，通常npm可以通過關聯gitlab直接登錄

• 確定你當前的鏡像指向npm鏡像而不是淘寶鏡像，如果不確定可以直接執行

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

• 運行添加用戶命令，依次輸入用戶，密碼，郵箱。

npm addUser

• 確保當前npm已經在瀏覽器登錄情況下執行發布命令

npm publish

如圖就是發布成功了

發布報錯

如果發布遇到403報錯，很有可能是你的包名即package.json里面的name字段與npm已經有的插件名重復了，需要修改一下再重新發布

修改過名字依然報錯， You cannot publish over the previously published versions: xxx,說明這個版本已經在npm存在，需要修改版本號

迭代

后續內容如果有變動，每次重新發布的時候，都需要手動的更改package.json/version的版本號,然后在執行發布的命令

使用示例

安裝

npm install node-fs-copy

在node代碼中，本地拷貝測試

const { fsCopy } = require('node-fs-copy')
// 把內容從本地D盤的test/test目錄，拷貝到test/test1目錄
fsCopy('d:/test/test', 'd:/test/test1')

服務器代碼拷貝

本地是沒有辦法直接拷貝服務器代碼的，如果需要拷貝服務器代碼，需要滿足一個條件

• node服務端代碼，與需要拷貝的文件在一個服務器上

比如作者的的服務器上的文件地址為/data/code-generator，node服務也部署在同一服務器的另一個目錄內

//在服務器上運行，表示把服務器的/data/code-generator文件內的內容，拷貝到當前項目的./temporary/test內
fsCopy('/data/code-generator', './temporary/test')

完成拷貝后，可以使用打包插件把該內容壓縮成zip包，輸出到前端，然后刪除該臨時文件./temporary/test,再刪除zip包

附上常用命令

npm init --yes(初始化配置)

npm i (會根據package.json里面的鍵dependencies，devDependencies來安裝相對應的包)

npm i 包(默認安裝一個最新的包，這個包在node_modules文件夾里面，并且會更新在你的package.json文件)

npm i 包@3.0.0（安裝一個指定版本的包，會更新在你的package.json文件）

npm i 包 --save-dev(安裝一個開發環境所需要的包，會更新在你的package.json文件)

npm uninstall 包（卸載一個包，會更新在你的package.json文件）

npm update 包(更新此包版本為最新版本，會更新在你的package.json文件)

npm run 腳本鍵(會根據package.json里面的"scripts"里面的腳本鍵自動執行相對于的值)

npm publish  (根據package.json的name發布一個包)

npm unpublish 包名 --force(卸載npm網站上自己上傳的包)

感謝你能夠認真閱讀完這篇文章，希望小編分享的“node文件如何寫成npm包并發布出去”這篇文章對大家有幫助，同時也希望大家多多支持億速云，關注億速云行業資訊頻道，更多相關知識等著你來學習!