# @architect/architect 中文文档

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

版本：12\.0\.1
npm 元数据更新时间：2026-09-05T00:21:28.520Z
中文译文更新时间：2026-11-06T14:30:36.030Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：36 kB，11 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：11 个
- 首次发布：2018-10-20T08:44:54.706Z
- 最新版本发布：2026-09-05T00:21:28.125Z
- 近 30 天下载量：13162（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：463（近 12 个月 5 个）

## 中文简介

创建,部署,并维护下一代基于AWS云函数的无服务器基础设施,并配有完整的本地,离线工作流程等.

## 安装

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

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

## README

[![Architect Logo](https://assets.arc.codes/architect-logo-500b@2x.png)](https://www.npmjs.com/package/@architect/architect)

[![GitHub CI status](https://github.com/architect/architect/workflows/Node%20CI/badge.svg)](https://github.com/architect/architect/actions?query=workflow%3A%22Node+CI%22) [![npm version](https://badge.fury.io/js/%40architect%2Farchitect.svg)](https://badge.fury.io/js/%40architect%2Farchitect) [![Apache-2.0 License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![](https://img.shields.io/discord/880272256100601927.svg?label=&logo=discord&logoColor=ffffff&color=5865F2&labelColor=grey)](https://discord.com/invite/y5A2eTsCRX)

> 在AWS无服务器基础设施上建立超可扩展数据库备份网络应用程序,并配有全本地,离线工作流程等. 全文见: [https://arc.codes (中文(简体) )](https://arc.codes/)

## 所需资源

-   **平台:** Linux, macOS, 视窗
-   **架构运行时间 :** 节点.js 18+
-   **函数运行时间( P) :**
    -   节点.js(可选): [已支持的版本](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)
        -   [`npm`](https://www.npmjs.com/) (可选):10+
        -   [`yarn`](https://yarnpkg.com/) (可选): 1+
    -   Python (可选) : [已支持的版本](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)
        -   [`pip3`](https://pip.pypa.io/en/stable/) (可选)
    -   Ruby( 可选) : [已支持的版本](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)
        -   [`bundle`](https://bundler.io/) (可选)
-   **其他函数运行时间 :**
    -   Java,.NET,戈兰克,兰布达运行时层(可选) : [已支持的版本](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html)

## 安装

确保至少安装了Node.js版本18.

打开终端安装 `arc`数字 :

```bash
npm i @architect/architect --save-dev
```

检查版本 :

```bash
npx arc version
```

> Protip: 运行 `arc` 没有参数可寻求帮助

## 当地工作

创建新应用程序 :

```bash
mkdir testapp
cd testapp
npx arc init
```

踢出本地 dev 服务器 :

```bash
npx arc sandbox
```

> `Cmd / Ctrl + c` 退出沙盒

## 部署到AWS

部署 `staging` 堆栈 :

```bash
npx arc deploy
```

> Protip: 创建额外的 `staging` 堆栈与 `--name`

船舶到a `production` 堆栈 :

```bash
npx arc deploy --production
```

## 在文本编辑器中添加建筑师语法

– 说吧 – **[VS 代码](https://marketplace.visualstudio.com/items?itemName=architect.architect)**

– 说吧 – **[下图文字](https://github.com/architect/sublime-package)**

– 说吧 – **[维姆](https://github.com/architect/vim-plugin)**

## 学多点

前往 [https://arc.codes (中文(简体) )](https://arc.codes/) 学习更多!

* * *

### 创建团队

[琥珀科斯利](https://github.com/amberdawn), (中文(简体) ), [安杰莉娜·法布罗](https://github.com/afabbro), (中文(简体) ), [布莱恩·勒鲁](https://github.com/brianleroux)简·方·阿德文特, [克里斯托弗·约瑟夫](https://github.com/kristoferjoseph), (中文(简体) ), [克里斯·博切尔斯](https://github.com/kborchers), (中文(简体) ), [瑞安区](https://github.com/ryanblock), (中文(简体) ), [斯宾塞·凯利](https://github.com/spencermountain)

### 特别谢谢

[郭平尧](https://github.com/pug132) 联 合 国 [建筑师 GitHub 名称](https://github.com/architect)

## 常见问题

### @architect/architect 是什么？

创建,部署,并维护下一代基于AWS云函数的无服务器基础设施,并配有完整的本地,离线工作流程等\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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