當你在 GitHub 上找到一個實用的開源套件，或者想要評估自己開發的專案影響力時，最直觀的指標就是「被多少專案引用」。這個數字不僅代表專案的受歡迎程度，也能作為技術選型時的重要參考依據。
但你可能會發現，不同平台顯示的數字常常不一樣。GitHub 說被 159 個專案使用，npm 頁面卻顯示只有 50 個 dependents，到底哪個才是真實的數字？本文將帶你了解三種查詢方法，以及這些數字背後的意義。
方法一：GitHub「Used by」統計
這是最直觀也最全面的查詢方式。只要前往 GitHub repository 頁面，在右側欄位就能看到「Used by」的數字，點擊後還能查看具體是哪些專案在使用。以 telegramify-markdown 為例，它的 GitHub 頁面顯示「Used by 159」，這代表有 159 個公開的 repository 將這個套件列為依賴項目。GitHub 的統計機制是掃描所有公開 repo 中的 package.json 檔案，只要在 dependencies、devDependencies 或 peerDependencies 中出現這個套件，就會被計入。
這個數字的優點是涵蓋範圍最廣，無論是已發布的 npm 套件，還是個人開發中的專案，只要是公開的 repository 都會被統計進去。對於評估一個套件的真實影響力來說，這是最有參考價值的指標。
方法二：npm 官網查看 Dependents
npm 官網也提供 Dependents（依賴者）統計，但這個數字通常會比 GitHub 的「Used by」少很多。原因在於 npm 只統計「已發布到 npm 且最新版本依賴該套件」的其他套件。
查詢方式很簡單，前往 npm 套件頁面（例如 https://www.npmjs.com/package/telegramify-markdown，在套件資訊區塊就能看到「Dependents」欄位，點擊可以查看詳細的依賴清單。
這個統計有幾個限制需要注意。首先，它只計算已發布的 npm 套件，個人專案或內部專案不會被計入。其次，只統計最新版本的依賴關係，如果某個專案使用的是舊版本，就不會出現在清單中。最後，它只計算套件對套件的依賴，不包含應用程式專案。
雖然數字較保守，但這個指標對於了解「有多少其他 npm 套件依賴這個專案」很有幫助，特別是在評估基礎工具類套件時。
方法三：使用命令列工具查詢
如果你想要更進階的分析，可以使用 npm-get-top-dependents 這個命令列工具。它能列出依賴某個套件的前 N 個專案，並提供更詳細的資訊。
安裝和使用方式如下：
· 快速使用（不需安裝）：npx npm-get-top-dependents telegramify-markdown
· 安裝後使用：npm install -g npm-get-top-dependents，然後執行 npm-get-top-dependents telegramify-markdown --count 20
這個工具特別適合需要深入分析依賴關係的情境，例如你想知道哪些知名專案在使用這個套件，或者想要追蹤依賴鏈的完整結構。
補充：下載量統計
雖然下載量不等於被引用數，但它能從另一個角度反映套件的使用程度。你可以使用 npm-stat.com 這個網站，輸入套件名稱後就能看到每日、每週、每月的下載量趨勢圖。
如果想要在命令列中快速查詢，可以使用 npx pkg-stats telegramify-markdown 指令，它會顯示最近的下載統計數據。
下載量的優點是能反映實際使用頻率，但無法區分是新安裝還是重複安裝，也無法排除 CI/CD 自動化流程產生的下載。因此這個指標適合搭配其他數據一起參考。
為什麼數字會不一樣？
了解不同平台的統計邏輯後，就能理解為什麼同一個套件會有不同的引用數字。
GitHub 的「Used by」是最寬鬆的統計，它計算所有公開 repository 中有列入 package.json 的專案，無論是應用程式、套件、個人練習專案都包含在內。這個數字反映的是「有多少開發者或團隊在使用」。
npm 的「Dependents」則是最嚴格的統計，只計算已發布到 npm 且使用最新版本的套件。這個數字反映的是「有多少其他 npm 套件依賴這個套件」，對於評估生態系影響力很有意義。
下載量統計則是持續累積的數據，反映的是「使用頻率」而非「使用者數量」。一個被少數專案頻繁使用的套件，下載量可能比被大量專案偶爾使用的套件還高。
實際應用建議
當你在評估一個開源套件是否值得使用時，建議綜合參考多個指標。GitHub 的「Used by」數字能讓你快速了解這個套件的普及程度，如果數字超過 100，通常代表它已經被社群認可。
npm 的「Dependents」則能幫你判斷這個套件在生態系中的位置。如果有許多知名套件依賴它，代表它的穩定性和重要性都很高。點進去查看具體是哪些套件在使用，也能幫助你判斷是否符合你的使用場景。
下載量趨勢圖則能顯示專案的活躍度。如果下載量持續上升，代表這個專案正在成長；如果突然下降，可能要留意是否有替代方案出現，或是專案本身出現問題。
搭配 GitHub 的 star 數、issue 數量、最後更新時間等資訊，就能全面評估一個開源專案的健康狀況。
結語
「被多少專案引用」看似簡單的數字，背後其實有不同的統計邏輯和意義。GitHub 的「Used by」提供最全面的視角，npm 的「Dependents」聚焦在套件生態系，下載量則反映實際使用頻率。
下次當你想要了解一個套件的影響力時，不妨三個指標都看看，你會發現這些數字能告訴你的，比想像中還要多。
參考資料
