无需登录 数据私有 本地保存

NPM 包信息卡片生成器 - 版本/许可证与每周下载

13
0
0
0
✓ 已复制到剪贴板

NPM 包信息卡片生成器

输入任意 NPM 包名，一键生成版本、许可证与每周下载量信息卡片，支持 Markdown 和 HTML 格式

热门包：
react vue lodash axios express typescript next tailwindcss vite prettier eslint webpack

正在获取包信息...

获取失败

Badge 样式：

周下载
README 预览效果 实时预览

↑ 这些卡片将展示在你的 GitHub README 中

↑ 暗色背景下的效果

复制代码
等待查询...
等待查询...
等待查询...
输入 NPM 包名开始生成

支持所有公开 NPM 包，包括 scoped 包（如 @angular/core）

常见问题
本工具可生成三种核心 NPM 包信息卡片（Badge）：版本号（显示最新版本）、许可证类型（如 MIT、Apache-2.0 等）以及每周下载量（近 7 天的下载总数）。这些卡片基于 Shields.io 服务生成，广泛应用于 GitHub README、项目文档和技术博客中，帮助开发者快速展示包的关键信息。
非常简单！复制工具生成的 Markdown 格式代码（形如 ![npm version](https://img.shields.io/...)），直接粘贴到你的 README.md 文件中即可。Markdown 格式在 GitHub、GitLab、NPM 官网等平台上都能正确渲染。如果你使用的是 HTML 文档，则复制 HTML 格式代码。Badge 图片由 Shields.io 动态生成，始终显示最新数据。
NPM 下载量数据由 api.npmjs.org 提供，通常有 24-48 小时的延迟。每周下载量统计的是过去 7 天的总下载次数。Shields.io 的 Badge 图片会缓存一段时间（通常几小时），因此 Badge 上显示的数据可能存在轻微延迟。如果你需要实时精确数据，可以直接访问 NPM 官网查看。
这通常是因为该包的 package.json 中未明确声明 license 字段，或者 license 字段的格式不符合 SPDX 规范。Shields.io 从 NPM Registry 获取许可证信息，如果无法解析，就会显示 "unknown"。建议包维护者在 package.json 中使用标准的 SPDX 标识符（如 "MIT"、"Apache-2.0"）来声明许可证。
不能。Shields.io 和 NPM 公开 API 只能访问公开发布的 NPM 包。私有包（付费 NPM 账号发布的私有包）的信息不会出现在公开 Registry 中，因此 Badge 也无法获取其数据。如果你需要为私有项目展示信息，可以考虑使用 Shields.io 的静态 Badge 功能手动指定版本和许可证信息。
本工具完全支持 Scoped 包。直接输入完整的包名（如 @angular/core、@babel/core）即可。工具会自动对特殊字符进行 URL 编码（@ → %40，/ → %2F），确保 API 请求和 Badge URL 都能正确工作。Scoped 包的 Badge 使用方式与普通包完全一致。
本工具支持 5 种 Shields.io 预设样式：Flat（扁平简约）、Flat Square（方形圆角）、Plastic（立体质感）、For the Badge（大号醒目）和 Social（社交风格）。如果需要自定义颜色，可以在生成的 Badge URL 末尾添加 &color=颜色代码 参数（如 &color=brightgreen 或 &color=ff69b4）。Shields.io 支持命名颜色和十六进制颜色码。
Markdown 格式（![alt](url)）适用于 Markdown 文件（如 README.md），语法简洁，在 GitHub、GitLab、NPM 等平台上自动渲染。HTML 格式（<img src="url" alt="alt">）适用于 HTML 文档，可以更灵活地控制图片样式（如添加 width、height 属性或 CSS 类名）。大多数情况下推荐使用 Markdown 格式，因为它在开发者生态中最为通用。
Shields.io 是一个开源且广泛使用的 Badge 服务，由社区维护并托管在 Cloudflare 全球 CDN 上，稳定性非常高。GitHub、GitLab 等平台的数百万项目都在使用它。如果极少数情况下服务不可用，Badge 图片会显示为裂图，不会影响 README 的其他内容。你也可以自托管 Shields.io 实例作为备选方案。
Shields.io 会自动对下载量数字进行人性化缩写：超过 1000 显示为 k（如 12.3k），超过 100 万显示为 M（如 5.2M），超过 10 亿显示为 B。这种格式化方式让 Badge 保持紧凑美观。同时，本工具在信息面板中会显示精确的原始数字（带千位分隔符），方便你了解准确数据。
🔧 相关工具