# @13w/docx 中文文档

规范地址：https://npmcn.com/package/%4013w/docx/

版本：9\.4\.0-fx2
npm 元数据更新时间：2025-04-16T12:22:01.822Z
中文译文更新时间：2026-11-06T15:44:53.751Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%4013w/docx
原文对照：https://npmcn.com/package/%4013w/docx/?lang=original
项目主页：https://docx.js.org/
源码仓库：https://github.com/dolanmiu/docx

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

- 包体积（解压后）：3.4 MB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=10
- 运行依赖：6 个
- 首次发布：2025-01-24T21:44:25.502Z
- 最新版本发布：2025-04-16T12:22:01.664Z
- 近 30 天下载量：2854（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 0 个）

## 中文简介

易地生成 .docx 文件与 JS/TS 和一个很好的声明API。 为节点和浏览器工作.

## 安装

```sh
npm install @13w/docx
```

也可以使用：`pnpm add @13w/docx`、`yarn add @13w/docx`、`bun add @13w/docx`

## README

![clippy the assistant](https://npmcn.com/package/%4013w/docx/logo/logo-animate.svg)

与JS/TS一起轻松地生成并修改.docx文件. 为节点和浏览器工作.

* * *

[![NPM version](https://badge.fury.io/js/docx.svg)](https://npmjs.org/package/docx) [![Downloads per month](https://img.shields.io/npm/dm/docx.svg)](https://npmjs.org/package/docx) [![GitHub Action Workflow Status](https://github.com/dolanmiu/docx/workflows/Default/badge.svg)](https://github.com/dolanmiu/docx/actions) [![Known Vulnerabilities](https://snyk.io/test/github/dolanmiu/docx/badge.svg)](https://snyk.io/test/github/dolanmiu/docx) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com/) [![codecov](https://codecov.io/gh/dolanmiu/docx/branch/master/graph/badge.svg)](https://codecov.io/gh/dolanmiu/docx) [![Docx.js Editor](https://img.shields.io/badge/Docx.js%20Editor-2b579a.svg?style=flat&logo=javascript&logoColor=white)](https://docxjs-editor.vercel.app/)

![drawing](https://i.imgur.com/QeL1HuU.png)

# 演示

## 浏览器

举例来说 `docx` 用于基本 `HTML/JS` 在浏览器环境中 :

-   [https://codepen.io/dolanmiu/pen/RwNeObg (英语)](https://codepen.io/dolanmiu/pen/RwNeObg)
-   [https://jsfidle.net/dolanmiu/onadx1gu/ 页面存档备份,存于互联网档案馆](https://jsfiddle.net/dolanmiu/onadx1gu/)

举例来说 `docx` 在职 `Angular`数字 :

-   [https://stackblitz.com/edit/angular-docx 页面存档备份,存于互联网档案馆](https://stackblitz.com/edit/angular-docx)
-   [https://stackblitz.com/edit/angular-wmd6k3 页面存档备份,存于互联网档案馆](https://stackblitz.com/edit/angular-wmd6k3)

举例来说 `docx` 在职 `React`数字 :

-   [https://stackblitz.com/edit/react-docx 互联网档案馆的存檔,存档日期2013-12-21](https://stackblitz.com/edit/react-docx)
-   [https://stackblitz.com/edit/react-docx-images (中文(简体) )](https://stackblitz.com/edit/react-docx-images) (将图像添加到 Word 文档)

这里有一个例子: `docx` 在职 `Vue.js`数字 :

-   [https://stackblitz.com/edit/vuejs-docx (中文(简体) )](https://stackblitz.com/edit/vuejs-docx)

## 节点

新闻 `endpoint` 编辑 `RunKit` 网站:

![RunKit Instructions](https://user-images.githubusercontent.com/2917613/38582539-f84311b6-3d07-11e8-90db-5885ae02c3c4.png)

-   [https://runkit.com/dolanmiu/docx-demo1 (英语)](https://runkit.com/dolanmiu/docx-demo1) - 简单的段落和文字
-   [https://runkit.com/dolanmiu/docx-demo2 (英语)](https://runkit.com/dolanmiu/docx-demo2) - 高级段落和文本
-   [https://runkit.com/dolanmiu/docx-demo3 (英语)](https://runkit.com/dolanmiu/docx-demo3) - 弹出点
-   [https://runkit.com/dolanmiu/docx-demo4 (英语)](https://runkit.com/dolanmiu/docx-demo4) - 简单的桌子
-   [https://runkit.com/dolanmiu/docx-demo5 (英语)](https://runkit.com/dolanmiu/docx-demo5) - 图像
-   [https://runkit.com/多兰米乌/多克克思-德莫6](https://runkit.com/dolanmiu/docx-demo6) -边际
-   [https://runkit.com/dolanmiu/docx-demo7 (英语)](https://runkit.com/dolanmiu/docx-demo7) - 风景
-   [https://runkit.com/dolanmiu/docx-demo8 (英语)](https://runkit.com/dolanmiu/docx-demo8) - 页眉和页脚
-   [https://runkit.com/dolanmiu/docx-demo10 (英语)](https://runkit.com/dolanmiu/docx-demo10) - 说吧 **我的 CV 用 docx 生成**

再来 [这里](https://github.com/dolanmiu/docx/tree/master/demo)

# 如何使用文档( D)

请参看 [https://docx.js.org/](https://docx.js.org/) 详细介绍如何使用这个库,示例和更多!

# 游戏场

经历 `docx` 在行动中通过 [Docx.js 编辑器](https://docxjs-editor.vercel.app/),一个互动游乐场,可以实时对结果进行编码并预览.

# 实例

检查 [演示文件夹](https://github.com/dolanmiu/docx/tree/master/demo) 用于实例.

# 捐款

阅读捐款准则 [这里](https://docx.js.org/#/contribution-guidelines)。 。 。 .

# 用于

[![drawing](https://i.imgur.com/zy5qWmI.png)](https://hfour.com/) [![drawing](https://i.imgur.com/OYP5tgS.png)](https://fuzzproductions.com/) [![drawing](https://i.imgur.com/zUDMfZ3.png)](https://www.mettzer.com/) [![drawing](https://i.imgur.com/wtNB1uq.png)](https://www.wisedoc.net/) [![drawing](https://i.imgur.com/suiH2zc.png)](https://www.dabblewriter.com/) [![drawing](https://i.imgur.com/1LjuK2M.png)](https://turbopatent.com/) [![drawing](https://i.imgur.com/dHMg0wF.gif)](http://www.madisoncres.com/) [![drawing](https://i.imgur.com/QEZXU5b.png)](https://www.beekast.com/) [![drawing](https://i.imgur.com/XVU6aoi.png)](https://herraizsoto.com/) [![drawing](https://i.imgur.com/fn1xccG.png)](http://www.ativer.com.br/) [![drawing](https://i.imgur.com/cmykN7c.png)](https://www.arity.co/) [![drawing](https://i.imgur.com/PXo25um.png)](https://www.circadianrisk.com/) [![drawing](https://i.imgur.com/AKGhtlh.png)](https://lexense.com/) [![drawing](https://i.imgur.com/9tqJaHw.png)](https://novelpad.co/) [![drawing](https://i.imgur.com/5bLKFeP.png)](https://proton.me/)

...还有更多!

* * *

[![patreon](https://user-images.githubusercontent.com/2917613/51251459-4e880480-1991-11e9-92bf-38b96675a9e2.png)](https://www.patreon.com/dolanmiu) [![browserstack](https://user-images.githubusercontent.com/2917613/54233552-128e9d00-4505-11e9-88fb-025a4e04007c.png)](https://www.browserstack.com/)

由 所制

## 常见问题

### @13w/docx 是什么？

易地生成 \.docx 文件与 JS/TS 和一个很好的声明API。 为节点和浏览器工作\.

### 如何安装 @13w/docx？

在项目目录运行 npm install @13w/docx，或使用 pnpm add / yarn add / bun add。

### @13w/docx 支持 TypeScript 吗？

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

### @13w/docx 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @13w/docx 需要什么版本的 Node\.js？

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

### @13w/docx 可以商用吗？

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

### @13w/docx 的下载量有多少？

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

### @13w/docx 还在维护吗？

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

