# @embroider/addon 中文文档

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

版本：0\.30\.0
npm 元数据更新时间：2026-02-04T19:45:02.876Z
中文译文更新时间：2026-11-13T15:45:06.028Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40embroider/addon
原文对照：https://npmcn.com/package/%40embroider/addon/?lang=original

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

- 包体积（解压后）：8.4 kB，8 个文件
- TypeScript 类型：未声明
- Node.js 要求：10\.\* \|\| \>= 12
- 运行依赖：1 个
- 首次发布：2020-10-21T21:28:21.298Z
- 最新版本发布：2020-11-03T21:34:44.350Z
- 近 30 天下载量：4132（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

Ember-cli 加通的默认蓝图.

## 安装

```sh
npm install @embroider/addon
```

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

## README

# @embroider/亚当

在Embroider的支持下帮助加价的公用事业.

## 兼容性

-   Ember.js v3.13或以上 (中文(简体) )
-   Ember CLI v2.13 或以上 (单位:千美元)
-   节点.js v10 或以上

## 安装

```
ember install @embroider/addon
```

## 公用事业

### `ensureSafeComponent`

此功能有助于您消除无法分析的 `{{component}}` 帮手 关于你为什么和如何这样做的充分解释,见 [添加作者指南](https://github.com/embroider-build/embroider/blob/master/ADDON-AUTHOR-GUIDE.md)。 。 。 .

Javascript 中的用法示例 :

```js
import { ensureSafeComponent } from '@embroider/addon';
import Component from '@glimmer/component';
import DefaultTitleComponent from './default-title';

export default class extends Component {
  get title() {
    return ensureSafeComponent(this.args.title || DefaultTitleComponent, this);
  }
}
```

```hbs
<this.title />
```

模板中的示例使用:

```hbs
{{#let (ensure-safe-component (or @title (component "default-title"))) as |Title|}}
  <Title />
{{/let}}
```

第一个论点是:

-   一个字符串。 如果我们看到一个字符串,我们会发出一个减速警告, 因为通过组件-as-strings 在Embroider下不能安全工作 `staticComponents` 启用 。 我们将返回一个可以安全引用的值( 通过角括号) .
-   曲折的组件定义( 即当有人这样做时, 得到的值类型) `<YourComponent @customThing={{component "fancy"}}/>`) (中文(简体) ). 因为它们总是可以安全引用的.
-   a 组件类,在这种情况下,如果您的嵌入版本尚未直接支持引用组件类,我们将将其转换为为为您绘制的目录组件定义.

在 Javascript 版本中,您必须通过第二个参数,该参数是所有者的任何对象(a) `Component` 实例效果很好.

## 捐款

见 [捐款](https://npmcn.com/package/%40embroider/addon/CONTRIBUTING.md) 详细指南.

## 许可证

本项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40embroider/addon/LICENSE.md)。 。 。 .

## 常见问题

### @embroider/addon 是什么？

Ember-cli 加通的默认蓝图\.

### 如何安装 @embroider/addon？

在项目目录运行 npm install @embroider/addon，或使用 pnpm add / yarn add / bun add。

### @embroider/addon 支持 TypeScript 吗？

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

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

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

### @embroider/addon 可以商用吗？

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

### @embroider/addon 的下载量有多少？

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

### @embroider/addon 还在维护吗？

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