# @architect/hydrate 中文文档

规范地址：https://npmcn.com/package/%40architect/hydrate/

版本：6\.0\.2
npm 元数据更新时间：2026-06-30T21:06:28.895Z
中文译文更新时间：2026-11-06T14:28:29.422Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：127 kB，43 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2019-05-30T19:06:30.796Z
- 最新版本发布：2026-06-30T21:06:28.493Z
- 近 30 天下载量：4169017（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：181（近 12 个月 5 个）

## 中文简介

架构依赖水合器和共享文件管理器

## 安装

```sh
npm install @architect/hydrate
```

也可以使用：`pnpm add @architect/hydrate`、`yarn add @architect/hydrate`、`bun add @architect/hydrate`

## README

# `@architect/hydrate` [![GitHub CI status](https://github.com/architect/hydrate/workflows/Node%20CI/badge.svg)](https://github.com/architect/hydrate/actions?query=workflow%3A%22Node+CI%22)

[@ architect/ 水合物](https://www.npmjs.com/package/@architect/hydrate) 确保建筑师管理的所有功能都安装了它们的依赖性. 包含所有必需的依赖性的函数被认为是"水分"——因此名称!

[@ architect/ 水合物](https://www.npmjs.com/package/@architect/hydrate) 支持使用以下软件包管理器以下列语言管理的依赖性:

-   **节点.js** 通过 `npm` 使用 `package.json` (可选) `package-lock.json`),或者通过 `yarn` 使用 `package.json` 财务报告和审定财务报表 `yarn.lock`
-   **蟒** 通过 `pip3` 使用一个 `requirements.txt` 文件
-   **鲁比** 通过 `bundle` 使用 `Gemfile` 财务报告和审定财务报表 `Gemfile.lock` 文件

# 所需资源

-   **节点.js 22或以后** 必须使用 `@architect/hydrate` 6.0.0及以上版本
-   对于Node.js 20 支持, 使用 `@architect/hydrate` 5.x版本 翻译:

# 安装

```
npm install @architect/hydrate
```

# API 密码

所有方法都接受 `options` 对象可以包括以下属性:

-   `autoinstall` - 说吧 **布尔** - 通过静态代码分析启用或禁用自动Lambda依赖树
    -   默认为 `false`
    -   用于 `install`
-   `basepath` - 说吧 **字符串** - 用于Hydrate搜索函数的文件系统路径
    -   默认当前工作目录
    -   如果您想要将一个函数或一个子集的函数水化,则有用
    -   用于 `install` + 键 `update`
-   `copyShared` - 说吧 **布尔** - 启用或禁止复制共享代码文件夹(例如:. `src/shared`进入Lambdas
    -   如果您想要将外部依赖性水化, 则需要禁用
    -   默认为 `true`
    -   用于 `install` + 键 `update`
-   `cwd` - 说吧 **字符串** - Hydrate 项目的根文件系统路径正在工作
    -   当前工作目录的默认值
    -   可能与 `basepath`; 如果与 `basepath`,指定项目的一个子集,其中 `basepath`,例如:
        -   `{ cwd: '/your/project/', basepath: '/your/project/src/http/' }` 运行水合物对 `/your/project/` (无需使用) `process.chdir`),并且只有水合物在 `/your/project/src/http/**`
    -   用于 `install` + 键 `update` + 键 `shared`
-   `hydrateShared` - 说吧 **布尔** - 在共享代码文件夹中启用或禁用依赖水合(例如:. `src/shared`(中文(简体) )
    -   如果您想要将外部依赖性水化, 则需要禁用
    -   默认为 `true`
    -   用于 `install` + 键 `update`
-   `inventory` - 说吧 **对象** - 建筑设计清单对象;内部一般使用
-   `local` - 说吧 **布尔** - 在安装可作为特定平台二进制分发的依赖性时,偏好本地平台
-   `only` - 说吧 **字符串** - 指定可能共享文件的子集 `shared` 复制到 Lambdas 中
    -   默认 Falsy
    -   接受 : `shared`, (中文(简体) ), `views`,或 `staticJson`
    -   用于 `shared`
-   `quiet` - 说吧 **布尔** - 禁用(大多数)记录
-   `symlink` - 说吧 **布尔** - 启用或禁用链接,而不是完整目录复制,对本地发展有用
    -   默认为 `false`
    -   用于 `install` + 键 `update` + 键 `shared`
-   `timeout` - 说吧 **数目** - 给每个软件包管理程序执行的时间(以毫秒计)
    -   用于 `install` + 键 `update`
-   `verbose` - 说吧 **布尔** - 启用动词记录

> **说明 `cwd` 对 `basepath`**数字 : `cwd` 用于 Hydrate 查找您的工程的表单和关键文件和文件夹, 而 `basepath` 瞄准特定路径。 当存在疑问时, 既不包含参数, Hydrate 将默认处理工作目录; 如果您知道需要在某个特定的地方瞄准 Hydrate , 但不确定要使用哪个参数, 使用 `cwd`。 。 。 .

## `hydrate.install(options[, callback]) → [Promise]`

安装函数依赖性,然后引用 [`hydrate.shared()`](https://npmcn.com/package/%40architect/hydrate/#readme-hydratesharedoptions-callback)。 。 。 .

确保本地发展行为接近 `staging` 财务报告和审定财务报表 `production` 尽可能, `hydrate.install()` (和其他水合物功能)使用:

-   **节点.js**数字 : `npm ci` 若为 `package-lock.json` 已存在 `npm i` (一) 如果不是;或 `yarn`
-   **蟒**数字 : `pip3 install`
-   **鲁比**数字 : `bundle install`

注:默认 `update` 还在共享文件夹中安装依赖性, 如 `src/shared` 财务报告和审定财务报表 `src/views`。 。 。 .

## `hydrate.update(options[, callback]) → [Promise]`

更新函数依赖性,然后引用 [`hydrate.shared()`](https://npmcn.com/package/%40architect/hydrate/#readme-hydratesharedoptions-callback)。 。 。 .

`update` 功能几乎与 [`install`](https://npmcn.com/package/%40architect/hydrate/#readme-hydrateinstalloptions-callback),但是它将更新对新版本的依赖性 _如果它们存在_通过以下方式做到这一点:

-   **节点.js**数字 : `npm update` 或者说 `yarn upgrade`
-   **蟒**数字 : `pip3 install -U --upgrade-strategy eager`
-   **鲁比**数字 : `bundle update`

注:默认 `update` 也更新共享文件夹中的依赖性, 如 `src/shared` 财务报告和审定财务报表 `src/views`。 。 。 .

## `hydrate.shared(options[, callback]) → [Promise]`

复制共享代码( 从 `src/shared` 财务报告和审定财务报表 `src/views`,或者您的习惯 `@shared` + 键 `@views` 路径,如果有的话)进入所有函数.

## 常见问题

### @architect/hydrate 是什么？

架构依赖水合器和共享文件管理器

### 如何安装 @architect/hydrate？

在项目目录运行 npm install @architect/hydrate，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 arc-hydrate，可以用 npx arc-hydrate 直接运行。

### @architect/hydrate 支持 TypeScript 吗？

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

### @architect/hydrate 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @architect/hydrate 需要什么版本的 Node\.js？

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

### @architect/hydrate 可以商用吗？

@architect/hydrate 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @architect/hydrate 的下载量有多少？

根据 npm 官方下载统计，@architect/hydrate 在 2026/10/07 – 2026/11/05 这 30 天内被下载 4,169,017 次，日均约 138,967 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @architect/hydrate 还在维护吗？

最新版本 6\.0\.2 发布于 2026/07/01（4 个月前）；至今共发布 181 个版本，其中过去 12 个月发布了 5 个；首次发布于 2019/05/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。