# mime-db 中文文档

规范地址：https://npmcn.com/package/mime-db/

版本：1\.54\.0
npm 元数据更新时间：2025-05-14T14:56:01.096Z
中文译文更新时间：2026-11-04T12:11:03.287Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/mime-db
原文对照：https://npmcn.com/package/mime-db/?lang=original
项目主页：https://github.com/jshttp/mime-db#readme
源码仓库：https://github.com/jshttp/mime-db

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：226 kB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>= 0\.6
- 运行依赖：0 个
- 首次发布：2014-08-14T22:17:35.560Z
- 最新版本发布：2025-03-18T15:06:44.354Z
- 近 30 天下载量：1214059455（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：64（近 12 个月 0 个）

## 中文简介

媒体类型数据库

## 安装

```sh
npm install mime-db
```

也可以使用：`pnpm add mime-db`、`yarn add mime-db`、`bun add mime-db`

## README

# mime-db

[![NPM Version](https://badgen.net/npm/v/mime-db)](https://npmjs.org/package/mime-db) [![NPM Downloads](https://badgen.net/npm/dm/mime-db)](https://npmjs.org/package/mime-db) [![Node.js Version](https://badgen.net/npm/node/mime-db)](https://nodejs.org/en/download) [![Build Status](https://badgen.net/github/checks/jshttp/mime-db/master?label=ci)](https://github.com/jshttp/mime-db/actions/workflows/ci.yml) [![Coverage Status](https://badgen.net/coveralls/c/github/jshttp/mime-db/master)](https://coveralls.io/r/jshttp/mime-db?branch=master)

这是一个mime类型和有关它们的信息的大型数据库。 它由一个单一的公共JSON文件组成，不包含任何逻辑， 允许它在使用API时尽可能保持不固执己见。 它汇集了以下来源的数据：

-   [https://www.iana.org/assignments/media-types/media-types.xhtml](https://www.iana.org/assignments/media-types/media-types.xhtml)
-   [https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types](https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types)
-   [https://hg.nginx.org/nginx/raw-file/default/conf/mime.types](https://hg.nginx.org/nginx/raw-file/default/conf/mime.types)

## 安装

```bash
npm install mime-db
```

### 数据库下载

如果您打算在web浏览器中使用它，您可以方便地通过 [jsDelivr](https://www.jsdelivr.com/)一个流行的CDN（内容分发网络）。为确保稳定性和兼容性，建议指定 [释放标签](https://github.com/jshttp/mime-db/tags) 而不是使用“master”分支。这是因为JSON文件的格式可能会在未来的更新中更改，并且依赖于特定的发布标记将防止这些更改引起的潜在问题。

```
https://cdn.jsdelivr.net/gh/jshttp/mime-db@master/db.json
```

## 用法

```js
var db = require('mime-db')

// grab data on .js files
var data = db['application/javascript']
```

## 数据结构

JSON文件是一个查找小写mime类型的映射。 每种mime类型都有以下属性：

-   `.source` -定义mime类型的地方。 如果没有设置，它可能是自定义媒体类型。
    -   `apache` - [Apache常用媒体类型](https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types)
    -   `iana` - [iana定义的媒体类型](https://www.iana.org/assignments/media-types/media-types.xhtml)
    -   `nginx` - [Nginx媒体类型](https://hg.nginx.org/nginx/raw-file/default/conf/mime.types)
-   `.extensions[]` -与此mime类型相关的已知扩展名。
-   `.compressible` -是否可以压缩该类型的文件。
-   `.charset` -与此类型关联的默认字符集，如果有的话。

如果未知，每个属性都可以 `undefined`。

## 关于MIME类型数据和Semver的注意事项

该包将编程api视为服务器兼容性。这意味着MIME类型解析为 _不_ 被认为是 在semver颠簸中。这意味着如果你想把你的 `mime-db` 您在应用程序中需要的数据。而 到目前为止，这个期望还没有在文档中设定，这就是包的运行方式，所以我们不觉得这是一个突破性的变化。

## 贡献

对该数据库进行贡献的主要方法是更新中的数据 上游来源之一。数据库从上游更新 并将拉入任何更改。

### 注册媒体类型

获取此库中包含的新媒体类型的最佳方法是注册 他们与IANA。社区注册程序概述于 [RFC 6838第5节](https://tools.ietf.org/html/rfc6838#section-5)． 类型 在IANA注册的文件都被自动拉入这个库。

### 直接包含

如果这是不可能/不可行的，他们可以直接添加在这里作为一个 “自定义”类型。要做到这一点，需要有一个主要的来源 明确列出媒体类型。如果扩展将被列为 与此媒体类型相关联，源必须明确地链接 媒体类型和扩展。

要编辑数据库，只能对其进行pr `src/custom-types.json` 或 `src/custom-suffix.json`。

这个 `src/custom-types.json` 文件是一个JSON对象，MIME类型为 键和值是一个具有以下键的对象：

-   `compressible` -不知道的可以省略，否则 `true`/`false` 来 指示由类型表示的数据通常是否可压缩。
-   `extensions` -包含与关联的文件扩展名数组 的类型。
-   `notes` -关于类型的人类可读注释，通常是什么类型。
-   `sources` -包括一个数组的url，其中MIME类型和相关的 扩展来自。这需要是a [主要来源](https://en.wikipedia.org/wiki/Primary_source)； 链接到类型聚合网站和维基百科 _不能接受的_。

要更新构建，请运行 `npm run build`。

## 常见问题

### mime-db 是什么？

媒体类型数据库

### 如何安装 mime-db？

在项目目录运行 npm install mime-db，或使用 pnpm add / yarn add / bun add。

### mime-db 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/mime-db 是否存在。

### mime-db 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 0\.6。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### mime-db 可以商用吗？

mime-db 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### mime-db 的下载量有多少？

根据 npm 官方下载统计，mime-db 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,214,059,455 次，日均约 40,468,649 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### mime-db 还在维护吗？

最新版本 1\.54\.0 发布于 2025/03/18（1\.6 年前）；至今共发布 64 个版本，其中过去 12 个月发布了 0 个；首次发布于 2014/08/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。