nodejs進階(1)——npm使用技巧和最佳實踐

来源:https://www.cnblogs.com/xwanzi/archive/2019/07/15/11190923.html
-Advertisement-
Play Games

nodejs進階教程,小白繞道!!! npm使用技巧和最佳實踐 前提:請確保全裝了node.js npm的最佳實踐 npm install是最常見的npm cli命令,但是它還有更多能力!接下來你會瞭解npm是如何在應用的整個生命周期幫助你的-從創建一個項目到開發和部署整個生命周期 認識npm 在開 ...


nodejs進階教程,小白繞道!!!

npm使用技巧和最佳實踐

前提:請確保全裝了node.js

npm的最佳實踐

npm install是最常見的npm cli命令,但是它還有更多能力!接下來你會瞭解npm是如何在應用的整個生命周期幫助你的-從創建一個項目到開發和部署整個生命周期

認識npm

在開始之前,我們先來看看一些查看正在運行的npm版本的命令

npm version

獲取當前npm cli正在使用的版本,你可以執行命令 npm version,這條命令除了返回版本外,還可以返回很多信息-當前包的版本,你正在使用的node.js的版本,openSSL或者V8的版本,以我本地安裝的node為例,結果如下:

npm help

和大多數的命令行工具一樣,npm也有一個內置的幫助函數, 可以獲取命令的描述和提要,比入我們想看看npm test命令是做什麼的,執行 npm help test

1 使用 npm init創建新項目

使用 npm init命令可以幫助你互動式地創建 package.json文件,會彈出項目名稱和描述的問題,有一個快速的解決方法 npm init--yes(或者簡寫 npm init-y),那麼就不會彈出任何問題了,僅僅是使用預設配置創建一個 package.json, 使用下麵的命令,你可以配置這些預設配置

  1. npm config set init.author.name YOUR_NAME
  2. npm config set init.author.email YOUE_EMAIL

2 查找正確的npm包

查找正確的npm包相當具有挑戰性-有成千上萬的包可供選擇,因此選擇正確的npm 包很令人苦惱了,然而,我們可以選擇一個模塊幫助我們發送HTTP請求 有一個網站可以幫助我們簡單地完成這個任務,它就是npms.io,它會展示包的質量,受歡迎度,和維護性,這些是通過一個模塊是否更新了依賴,是否有提示配置,是否做了測試覆蓋,最近有沒有提交記錄來綜合計算得出的

3 檢查npm包

一旦我們找到了我們的模塊(在我們的例子中是一個request模塊),我們應該看一下文檔,查看issues,以便更好地瞭解我們即將引入到應用中的包,不要忘記你使用的npm包越多,你的項目的風險就越高

如果你想在cli中打開這個模塊的首頁,執行

npm home request

打開模塊的issues

npm bugs request

或者你只是想查看模塊的git倉庫,執行下麵的命令

npm repo request

4 保存依賴

npm採用semver進行控制

所謂SEMVER,指的是語義化版本,其規則概述如下: 版本格式:主版本號.次版本號.修訂號,版本號遞增規則如下:

  • 主版本號:新的架構調整,不相容老版本
  • 次版本號:新增功能,相容老版本
  • 修訂號:修複bug,相容老版本。

一旦你決定將第三方包引入你的項目,你必須安裝和保存它,最常見的命令是 npm install some-package,如果你想自動將包信息添加進 package.json文件,你需要執行 npm install some-package--save

npm預設會帶著'^’這個首碼保存你的包,具體的安裝規則如下:

^version

  1. 相容某個版本
  2. 版本號中最左邊的非0數字的右側可以任意
  3. 如果缺少某個版本號,則這個版本號的位置可以任意
  4. 如:^1.1.2 ,表示>=1.1.2<2.0.0
  5. 可以是1.1.21.1.3,.....,1.1.n1.2.n,.....,1.n.n
  6. 如:^0.2.3 ,表示>=0.2.3 <0.3.0
  7. 可以是0.2.30.2.4,.....,0.2.n
  8. 如:^0.0,表示 >=0.0.0 <0.1.0
  9. 可以是0.0.00.0.1,.....,0.0.n

這也意味著當你下次執行 npm install的時候,即使主版本沒有更改,次版本或者修訂版本發生了改變,你的這個模塊會重裝,你可以執行下麵的命令修改安裝包版本規則 npm configsetsave-prefix='~'

這個包首碼的安裝規則如下:

~version

  1. 大概匹配某個版本
  2. 如果minor版本號指定了,那麼minor版本號不變,而patch版本號任意
  3. 如果minorpatch版本號未指定,那麼minorpatch版本號任意
  4. 如:~1.1.2,表示>=1.1.2 <1.2.0,可以是1.1.21.1.3,.....,1.1.n
  5. 如:~1.1,表示>=1.1.0 <1.2.0
  6. 如:~1,表示>=1.0.0<2.0.0
  7. 可以是1.0.01.0.1,.....,1.1.n1.2.n,.....,1.n.n

如果你想保存指定的版本號,執行 npm configsetsave-exacttrue

5 鎖定依賴

上面已經介紹過了,npm採用語義化的版本號 semver 進行控制,讓開發過程中依賴的獲取和升級變得非常容易,但不嚴格的版本號控制,也帶來了不確定性

  • npm建議使用semver版本,但是部分包不遵循semver;
  • package.json 可以使用精確的版本號控制你的直接依賴包,但第三方依賴的包無法管理;
  • 在開發階段執行得到的包的版本,和後續部署時得到的可能是不一致的,更不可控的是,你依賴的第三方包也有這樣的情況會導致潛在的上線風險。

可以用 npm shrinkwrap解決這個問題,這條命令會生成一個npm-shrinkwrap.json,這個文件裡面不僅包含了安裝在你機器上的指定版本的包,而且還有包的指定版的依賴包,一旦在項目的根目錄下有這個文件,你執行 npm install命令會重新生成一個相同的依賴樹

6 檢查項目的依賴包有無更新

npm有一個內置的工具方法命令 npm outdated可以檢查過時的包,在你項目下運行`npm outdated'即可,但是手動執行檢查更新命令就很煩了,有一個可以自動執行包更新檢查的工具Greenkeeper,有興趣的童鞋可以戳進鏈接瞭解。

7 開發包

在本地開發npm包的時候,我們可以使用 npm link命令,將npm模塊鏈接到對應的運行項目中去,方便地對模塊進行調試和測試

舉個例子來說明是什麼意思以及怎麼使用吧

我們現在有兩個項目,分別是npm-link-module和npm-link-test,其中npm-link-module是我們要開發的npm包,npm-link-test用來測試我們開發的包

在npm-link-module下執行 npm init-y生成一個預設的包配置文件package.json,在目錄下新建index.js如下,寫個簡單的日期轉換函數

  1. function formateTime(date) {
  2. let year = date.getFullYear();
  3. let month = date.getMonth() + 1;
  4. let day = date.getDay();
  5. month = month < 10 ? '0' + month : month;
  6. day = day < 10 ? '0' + day : day;
  7. return year + '-' + month + '-' + day;
  8. }
  9. module.exports = formateTime

然後執行 npm link, 執行命令後,npm-link-module會根據package.json上的配置,被鏈接到全局,路徑是 {prefix}/lib/node_modules/<package>,這是官方文檔上的描述,我們可以使用npm config get prefix命令獲取到prefix的值(我使用的是windows,實際被鏈接到的路徑是 {prefix}/node_modules/<package>) 我們可以看到,已經在這個目錄下麵生成了一個npm-link-module的快捷方式

再進入npm-link-test,執行 npm init-y生成包文件,接著執行 npm link npm-link-module 可以看到在這個項目的node_modules目錄下生產了一個npm-link-module的快捷方式 現在npm-link-test這個項目就可以引用這個 npm-link-module這個模塊了

我們在npm-link-test的目錄下新建index.js文件,內容如下

  1. let formateTime = require('npm-link-module');
  2. let date = new Date();
  3. console.log(formateTime(date));

然後執行node index.js,可以看到命令行已經列印出函數的執行結果了

然後,我們修改下npm-link-module中的index.js文件的日期函數,返回結果就修改成返回斜線格式的日期

  1. return year + '/' + month + '/' + day;

再回到npm-link-test目錄下執行index.js,可以看到,返回結果已經變成了斜線的日期

看到了吧,所有對npm-link-module的修改會被直接映射到npm-link-test/node_modules/npm-link-module

說明一下,這個nodejs進階教程計劃寫10篇左右,現在心中有大致的框架,所以準備邊寫邊梳理,寫完會將教程目錄列出來

下麵是我的個人前端公眾號,歡迎大家掃碼關註,第一時間獲取教程的更新信息


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 本文微信公眾號「AndroidTraveler」首發。 背景 最近部門有新入職員工,作為規劃技術路線的導師,這邊給新員工安排了學習路線。 除了基本的學習路線之外,每次溝通,我都留了一個小問題,讓小伙伴去思考。 這些問題有些是剛接觸 Android 開發的小伙伴所不熟悉的,有些則是部分初級工程師都沒有 ...
  • <!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Title</title></head><body> <!--註釋內容--> <h1>你好</h1> <p>&nbsp;&nbsp;&nbsp;&nbsp;這是一行 ...
  • <!doctype html> <html lang="en"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, ...
  • <!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Title</title></head><body> <!--註釋內容--></body></html> 標簽的意義: 1、<!DOCTYPE html> 指明這是 ...
  • 問題一:node_gyp使用版本不對 問題:明明裝的是5.0.2版本,使用的卻是3.9.2版本。 原因:命令上已經寫明,在npm_config_node_gyp未配置情況,node_gyp使用的版本。 解決:刪掉前者路徑的node-gyp。 問題二:無法找到 v140 的生成工具 問題:依賴的c++ ...
  • a.純後端渲染:頁面發送請求,後端伺服器中將數據拼成完整DOM樹,並轉換成一個位元組流作為HTTP Response的body返回給瀏覽器。優點在於 返回的HTTP Response是包含著全部頁面內容,可以讓用戶更加快捷的看到頁面的主體部分。也方便了網站的seo(搜索引擎優 化)。 b.純前端渲染 ...
  • jQuery引入 下載鏈接: [jQuery官網](https://jquery.com/),首先需要下載這個jQuery的文件,然後在HTML文件中引入這個文件,就可以使用這個文件中幫我們提供的jquery的介面了。 引入: <script src = 'jquery.js'> </script> ...
  • 好一段時間沒寫了,今天寫一下JavaScript的迴圈和輸出吧! 其實JavaScrip的迴圈跟C#、Java的迴圈用法是相同的。 先在說一下輸出語句! JavaScript 可以通過不同的方式來輸出數據: 使用 window.alert() 彈出警告框。 使用 document.write() 方 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...