# @betit/rollup-plugin-rename-extensions 中文文档

规范地址：https://npmcn.com/package/%40betit/rollup-plugin-rename-extensions/

版本：0\.1\.0
npm 元数据更新时间：2022-04-04T18:34:48.749Z
中文译文更新时间：2026-11-07T23:49:34.832Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40betit/rollup-plugin-rename-extensions
原文对照：https://npmcn.com/package/%40betit/rollup-plugin-rename-extensions/?lang=original
项目主页：https://github.com/GiG/rollup-plugin-rename-extensions
源码仓库：https://github.com/GiG/rollup-plugin-rename-extensions

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

- 包体积（解压后）：21.8 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2019-05-09T15:32:25.223Z
- 最新版本发布：2019-10-08T07:24:44.683Z
- 近 30 天下载量：6481（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 0 个）

## 中文简介

在滚动中释放文件扩展名前重命名的插件

## 安装

```sh
npm install @betit/rollup-plugin-rename-extensions
```

也可以使用：`pnpm add @betit/rollup-plugin-rename-extensions`、`yarn add @betit/rollup-plugin-rename-extensions`、`bun add @betit/rollup-plugin-rename-extensions`

## README

# 重命名扩展插件

从 RollUp 取出模块并重命名其文件扩展名的滚动插件 。 用于使用时 `preserveModules`。插件也将解析 所有模块代码和重写导入/导出以匹配新文件名.

## 安装

```bash
npm i --save-dev @betit/rollup-plugin-rename-extensions
```

## 使用量

例如,我们如何转换 `.ts` `.vue` 改为 `.js` 财务报告和审定财务报表 `.vue.js` 页:1.

```js
import renameExtensions from '@betit/rollup-plugin-rename-extensions';

// Rollup Configuration
export default {
    input: './src/index.js',
    preserveModules: true,
    /* ... */
    plugins: [
        // After transforms...
        renameExtensions({
            include: ['**/*.ts', '**/*.vue'],
            mappings: {
                '.vue': '.vue.js',
                '.ts': '.js',
            },
        })
    ],
},
```

## 选项

```typescript
export interface IRenameExtensionsOptions {
    /**
     * Files to include for potential renames.
     * Also denotes files of which may import a renamed module in
     * order to update their imports.
     */
    include?: Array<string | RegExp> | string | RegExp | null;

    /**
     * Files to explicitly exclude
     */
    exclude?: Array<string | RegExp> | string | RegExp | null;

    /**
     * Generate source maps for the transformations.
     */
    sourceMap?: boolean;

    /**
     * Babel plugins to use for parsing. Defaults to:
     * `dynamicImport`, `classProperties`, `objectRestSpread`
     *
     * For a full list visit https://babeljs.io/docs/en/babel-parser#plugins
     */
    parserPlugins?: ParserPlugin[];

    /**
     * Object describing the transformations to use.
     * IE. Input Extension => Output Extensions.
     * Extensions should include the dot for both input and output.
     */
    mappings: Record<string, string>;
}
```

## 常见问题

### @betit/rollup-plugin-rename-extensions 是什么？

在滚动中释放文件扩展名前重命名的插件

### 如何安装 @betit/rollup-plugin-rename-extensions？

在项目目录运行 npm install @betit/rollup-plugin-rename-extensions，或使用 pnpm add / yarn add / bun add。

### @betit/rollup-plugin-rename-extensions 支持 TypeScript 吗？

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

### @betit/rollup-plugin-rename-extensions 支持 ESM 还是 CommonJS？

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

### @betit/rollup-plugin-rename-extensions 可以商用吗？

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

### @betit/rollup-plugin-rename-extensions 的下载量有多少？

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

### @betit/rollup-plugin-rename-extensions 还在维护吗？

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