# @firecms/data\_import 中文文档

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

版本：3\.5\.2
npm 元数据更新时间：2026-11-10T18:01:01.599Z
中文译文更新时间：2026-11-14T19:36:12.168Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：530 kB，54 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react \>=18\.3\.1 \|\| \>=19\.0\.0，react-dom \>=18\.3\.1 \|\| \>=19\.0\.0，react-router ^6\.28\.0，react-router-dom ^6\.28\.0
- 首次发布：2023-10-23T18:53:29.484Z
- 最新版本发布：2026-11-10T18:01:01.232Z
- 近 30 天下载量：5674（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：317（近 12 个月 79 个）

## 中文简介

此插件可直接从 FireCMS 界面导入数据到 Firestore 收藏 。 它在收藏视图中添加了导入按钮,提供了从CSV或JSON文件中大量添加或更新数据的简单方法.

## 安装

```sh
npm install @firecms/data_import
```

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

## README

# FireCMS 数据导入插件

此插件可直接从 FireCMS 界面导入数据到 Firestore 收藏 。 它在收藏视图中添加了导入按钮,提供了从CSV或JSON文件中大量添加或更新数据的简单方法.

## 安装

```bash
npm install @firecms/data_import
# or
yarn add @firecms/data_import
```

## 特征

-   从 CSV 或 JSON 格式导入数据到 Firestore 收藏
-   在导入前验证数据,以确保完整性
-   与 FireCMS 分析活动合并
-   支持大宗数据的创建和更新

## 基本用途

```tsx
import React from "react";
import { FireCMS } from "@firecms/core";
import { useImportPlugin } from "@firecms/data_import";


export default function App() {

    // Basic setup with default options
    const importPlugin = useImportPlugin();

    return <FireCMS
        name={"My Online Shop"}
        plugins={[importPlugin]}
        authentication={myAuthenticator}
        collections={myCollections}
        firebaseConfig={firebaseConfig}
    />;
}
```

## 高级配置

您可以用这些选项自定义导入行为 :

```tsx
const importPlugin = useImportPlugin({
    // Track import events
    onAnalyticsEvent: (event, params) => {
        console.log("Import event:", event, params);
        // Example events: "import_started", "import_completed", "import_error"
    }
});
```

## 配置选项

| 选项 | 类型 | 说明 |
| --- | --- | --- |
| `onAnalyticsEvent` | `(event: string, params?: any) => void` | 调用以跟踪导入事件 |

## 与导出整合

对于完整的数据管理解决方案,同时使用导入和导出插件:

```tsx
import { useImportPlugin } from "@firecms/data_import";
import { useExportPlugin } from "@firecms/data_export";

// Set up both plugins
const importPlugin = useImportPlugin();
const exportPlugin = useExportPlugin();

// Add both to your FireCMS app
return (
    <FireCMS
        // ...other props
        plugins={[importPlugin, exportPlugin]}
    >
        {/* ... */}
    </FireCMS>
);
```

## 补充说明

-   导入功能在导入前会根据您的收藏计划验证数据
-   从 JSON 导入复杂数据类型( 地图、 数组、 引用) 时支持
-   从 CSV 导入时, 类型转换按照您的计划进行
-   大量进口货物分批加工,以避免防火店的限制

## 常见问题

### @firecms/data\_import 是什么？

此插件可直接从 FireCMS 界面导入数据到 Firestore 收藏 。 它在收藏视图中添加了导入按钮,提供了从CSV或JSON文件中大量添加或更新数据的简单方法\.

### 如何安装 @firecms/data\_import？

在项目目录运行 npm install @firecms/data\_import，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.3\.1 \|\| \>=19\.0\.0）、react-dom（\>=18\.3\.1 \|\| \>=19\.0\.0）、react-router（^6\.28\.0）、react-router-dom（^6\.28\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @firecms/data\_import 支持 TypeScript 吗？

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

### @firecms/data\_import 支持 ESM 还是 CommonJS？

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

### @firecms/data\_import 可以商用吗？

@firecms/data\_import 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @firecms/data\_import 的下载量有多少？

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

### @firecms/data\_import 还在维护吗？

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