# @deque/dot 中文文档

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

版本：1\.1\.5
npm 元数据更新时间：2026-07-08T23:43:49.892Z
中文译文更新时间：2026-11-12T00:24:46.324Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：67.7 kB，37 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-07-17T17:34:29.936Z
- 最新版本发布：2019-11-06T17:36:29.248Z
- 近 30 天下载量：9181（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

简洁而快的 Javascript 诱导与节点和其他 javascript 环境相兼容

## 安装

```sh
npm install @deque/dot
```

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

## README

# 点数

为寻找最快而简洁的JavaScript turlating功能而创建,以V8和节点下的性能为重点. 它显示了节点和浏览器的出色性能.

doT.js是快的,小的,没有依赖关系.

[![Build Status](https://travis-ci.org/olado/doT.svg?branch=master)](https://travis-ci.org/olado/doT) [![npm version](https://badge.fury.io/js/dot.svg)](https://www.npmjs.com/package/dot) [![Coverage Status](http://coveralls.io/repos/github/olado/doT/badge.svg?branch=master)](https://coveralls.io/github/olado/doT?branch=master)

## 特征

```
custom delimiters
runtime evaluation
runtime interpolation
compile-time evaluation
partials support
conditionals support
array iterators
encoding
control whitespace - strip or preserve
streaming friendly
use it as logic-less or with logic, it is up to you
```

## 医生、现场操场和样本

[http://olado.github.com/doT (中文(简体) )](http://olado.github.com/doT) (待办:在1.0版中添加了新功能的更新文件)

## 1.0.0版本中的新版本

#### 在部分中添加参数支持

```html
{{##def.macro:param:
    <div>{{=param.foo}}</div>
#}}

{{#def.macro:myvariable}}
```

#### 节点模块现在支持从指定的路径自动编译点模板

```js
var dots = require("dot").process({ path: "./views"});
```

这将汇编在指定路径下找到的.def,.dot,.jst文件 . 细节

-   它忽略了子目录.
-   模板文件可以同时有多个扩展.
-   带有.def扩展名的文件可以通过 {def.name} 包含在其他文件中
-   带有.dot扩展名的文件被编译为同名的函数和 可作为渲染器访问。 文件名
-   有.jst扩展名的文件被编译为.js文件. 制作的.js文件可以是: 装入为普通JS,AMD模块,或刚被安装到全局变量(默认设置为窗口). 提交)
-   在.jst文件中定义的所有内在定义是 编译为单独的函数,并通过 render.filename.definename提供

基本用途:

```js
       var dots = require("dot").process({path: "./views"});
       dots.mytemplate({foo:"hello world"});
```

以上片段将: \* 汇编视图文件夹中的所有模板(.dot、.def、.jst) \* 将从.jst模板汇编的.js文件放入同文件夹 这些文件可以随需要一起使用,即需要(./views/mytemplate") \* 返回一个带有从.dot模板所编译的函数的对象作为其属性 \* 微分模板

#### 将点模板编译为 js 文件的 CLI 工具

```
./bin/dot-packer -s examples/views -d out/views
```

## 表达式示例

```
Many people are using doT with express. I added an example of the best way of doing it examples/express:
```

[带快件的多T](https://npmcn.com/package/%40deque/dot/examples/express)

## 页:1

```
doU.js is here only so that legacy external tests do not break. Use doT.js.
doT.js with doT.templateSettings.append=false provides the same performance as doU.js.
```

## 作者

劳拉·多克托罗娃 [@olado (英语)](http://twitter.com/olado)

## 许可证

doT根据麻省理工学院的许可证持有执照. (见LICENSE-DOT)

![logo by Kevin Kirchner](http://olado.github.io/doT/doT-js-100@2x.png)

谢谢 [@ KevinKirchner (英语)](https://twitter.com/kevinkirchner) 为标志.

## 常见问题

### @deque/dot 是什么？

简洁而快的 Javascript 诱导与节点和其他 javascript 环境相兼容

### 如何安装 @deque/dot？

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

### @deque/dot 支持 TypeScript 吗？

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

### @deque/dot 支持 ESM 还是 CommonJS？

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

### @deque/dot 可以商用吗？

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

### @deque/dot 的下载量有多少？

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

### @deque/dot 还在维护吗？

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