# find-cache-dir 中文文档

规范地址：https://npmcn.com/package/find-cache-dir/

版本：6\.0\.0
npm 元数据更新时间：2025-04-14T07:08:00.548Z
中文译文更新时间：2026-11-05T16:39:42.469Z
软件包许可：MIT

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

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

弃用说明：Renamed to \`find-cache-directory\`\.

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

- 包体积（解压后）：7.2 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=16
- 运行依赖：2 个
- 首次发布：2015-12-30T05:27:14.863Z
- 最新版本发布：2025-04-08T15:30:14.851Z
- 近 30 天下载量：167306115（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 0 个）

## 中文简介

查找常见的标准缓存目录

## 安装

```sh
npm install find-cache-dir
```

也可以使用：`pnpm add find-cache-dir`、`yarn add find-cache-dir`、`bun add find-cache-dir`

## README

# 查找缓存目录

> 查找常见的标准缓存目录

这个 [`nyc`](https://github.com/istanbuljs/nyc) 财务报告和审定财务报表 [`AVA`](https://ava.li/) 项目决定在存储缓存信息的通用目录结构上实现标准化:

```sh
# nyc
./node_modules/.cache/nyc

# ava
./node_modules/.cache/ava

# your-module
./node_modules/.cache/your-module
```

这个模块使得根据这个共享的光谱正确定位缓存目录变得容易. 如果这种模式变得无所不在,则清除缓存以备多个依赖变得简单而一致:

```
rm -rf ./node_modules/.cache
```

## 安装

```sh
npm install find-cache-dir
```

## 使用量

```js
import findCacheDirectory from 'find-cache-dir';

findCacheDirectory({name: 'unicorns'});
//=> '/user/path/node-modules/.cache/unicorns'
```

## API 密码

### 找到 CacheDirectory( 选项 )

使用指定的选项查找缓存目录.

算法检查 `CACHE_DIR` 环境变量,如果不设定为 `true`, (中文(简体) ), `false`, (中文(简体) ), `1` 或者说 `0`。如果没有找到,它试图找到一个 `package.json` 文件中,搜索此选项的每个父目录 `cwd` 指定(或暗示来自其他选项)。 它返回一个 `string` 包含缓存目录的绝对路径,或 `undefined` 若为 `package.json` 从未找到,或者 `node_modules` 目录不可写入.

#### 选项

类型 : `object`

##### 名称

_需求_  
类型 : `string`

应该与您的工程名称相同 `package.json`。 。 。 .

##### 文件

类型 : `string[]`

将搜索到共同父目录的文件序列 。 此常见的父目录将用来代替 `cwd` 选项.

##### 数据

类型 : `string`  
默认 `process.cwd()`

开始搜索的目录 `package.json` 从.

##### 创建

类型 : `boolean`  
默认 `false`

返回前同步创建目录 .

## 提示

-   测试使用 `find-cache-dir`,设置 `CACHE_DIR` 环境变量可以暂时覆盖已解决的目录.

## 收养人

-   [`ava`](https://avajs.dev/)
-   [`nyc`](https://github.com/istanbuljs/nyc)
-   [`storybook`](https://github.com/storybookjs/storybook)
-   [`babel-loader`](https://github.com/babel/babel-loader)
-   [`eslint-loader`](https://github.com/MoOx/eslint-loader)
-   [还有..](https://www.npmjs.com/browse/depended/find-cache-dir)

## 常见问题

### find-cache-dir 是什么？

查找常见的标准缓存目录注意：该包已被作者标记为弃用——Renamed to \`find-cache-directory\`\.

### 如何安装 find-cache-dir？

在项目目录运行 npm install find-cache-dir，或使用 pnpm add / yarn add / bun add。

### find-cache-dir 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### find-cache-dir 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### find-cache-dir 需要什么版本的 Node\.js？

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

### find-cache-dir 可以商用吗？

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

### find-cache-dir 的下载量有多少？

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

### find-cache-dir 还在维护吗？

最新版本 6\.0\.0 发布于 2025/04/08（1\.6 年前）；至今共发布 14 个版本，其中过去 12 个月发布了 0 个；首次发布于 2015/12/30。作者已将其标记为弃用，新项目建议寻找替代方案。