# @blitzjs/rpc 中文文档

规范地址：https://npmcn.com/package/%40blitzjs/rpc/

版本：3\.0\.2
npm 元数据更新时间：2025-09-11T13:04:04.661Z
中文译文更新时间：2026-11-08T06:58:51.989Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40blitzjs/rpc
原文对照：https://npmcn.com/package/%40blitzjs/rpc/?lang=original
项目主页：https://blitzjs.com/
源码仓库：https://github.com/blitz-js/blitz

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

- 包体积（解压后）：204 kB，31 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：8 个
- peer 依赖：@tanstack/query-core 5\.51\.1，blitz 3\.0\.2，next \*，react \*
- 首次发布：2022-04-15T00:32:17.457Z
- 最新版本发布：2025-09-11T13:04:04.378Z
- 近 30 天下载量：60205（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：177（近 12 个月 0 个）

## 中文简介

[![Blitz.js](https://raw.githubusercontent.com/blitz-js/art/master/github-cover-photo.png)](https://blitzjs.com/)

## 安装

```sh
npm install @blitzjs/rpc
```

也可以使用：`pnpm add @blitzjs/rpc`、`yarn add @blitzjs/rpc`、`bun add @blitzjs/rpc`

## README

[![Blitz.js](https://raw.githubusercontent.com/blitz-js/art/master/github-cover-photo.png)](https://blitzjs.com/)

 [![](https://img.shields.io/badge/Join%20our%20community-6700EB.svg?style=for-the-badge&labelColor=000000&logoWidth=20&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAYAAADDPmHLAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAQ9SURBVHgB7d3dVdtAEIbhcSpICUoH0IEogQqSVBBSAU4FSSpIOoAORAfQgSghHXzZ1U/YcMD4R9rZmf2ec3y448LyiNf27iLiGIAmPLrweC9Un3DhrzG6EarLNP09nlwJ1SOZ/lQr5N80/S/p2QMVCBf5N17XCfm1Y/rBHqjAG9PPHvBsz+mf9WAP+HLA9M/YA14cOP2payH7jpj+VCtk1wnTP+vj7xCy6cTpn7EHLMLp059iD1iD8eveJbVCNsSLheX1YA/YgOWnf8YeKB3Wmf7Ud6Fy4f/FHmtpxbl3YlC4MJ/Cj0bWdwPnPbARg+L0S54XQHS32WwuxClzd4CM0z9rPfeAuTtA5ulPXYQ7wZ04Y+oOoDD9KZc9YOoOoDj9s4dwFzgXR6w1wIPoOvPWA9buAHEJ173o3gWiy3AnuBUHLEbgmYwvAk1/wuM8vAgexThzbwPDkx7/DHwVXfFOxP2GmsKd4Ab6zPeAyU8CI7AHFmH2BRCBPXAyk18GzUrqAXCTiR4ssyj0VFw/oCU8+e+RZ33AWz6KMaYbIIWxB+JSLs1bsbkeMN0AqakHvoku9oA2sAfqBvbAQdw0QArsgb25aYBUQT3QgT2gB+yBuqGcHij2UCqXDZACe2Anlw2QYg/QAOyBuoE98CL3DZDCuK4/rh/Q7oGL6U+TOvcNkJoijN8X1C48+T+g75eQDrAH/qmqAVJgDwyqaoAUe4AGYA/UDZX3QLUNkEIZPRCd5+6BahsgVUgPROwBTSijB7jpVAvGHriHvmw9wAZ4BpX1ABvgmakHtPcbRuwBTWAPULgAV9D/jKDY9YRvwvgEaurD44uQHvAol7qBW7WKluVtIHiUS7GyvA0s6CiXDnxrpQfsgbqBS7GKk/2jYHCrVlGyfxTMrVo0ALdq1Q3sgSKofh0M9oA61a+D2QM0AHugbmAPqClmSRjK2apVVQ8UsySsoK1aHdgDesCtWnUDeyCrIpeFg1u3sylyWTi3btMA7IG6gT2wuuK3hoE9sKrit4YVslWLPaAN7IG6ocKt2zmY2h4O9sDiTG0PZw/QANy6XTewBxZj9ogYVHy025LMHhEz9cBn0We6B0yfERReBLfhx0/R1YQHPx/QBPbA0VwcEwf2wNFcHBPHHjiem3MC2QPHcXdSaJjA+KfgTPQ8hhfjBzHC40mhlzJ+Xq9lK4a4PCs43AVaGTed5mZq+iOXZwWHi3AnOj2wFWNcnxYe7gTxLtBKHuamP/J+Wnh8a5irB7ZC5Yk9gPX1QuXC+usHWqGyhYvUYR0a7zboUOFCNVhnk0krZAOW7wFOvzXhom2xnEbIHizTA1wEYhWW6YFGyC6c1gOcfg9wfA80Qj7g8B7g9HuCww+haIR8wf49wOn3Cvv9k8tGyC/s7gFOv3fY3QONkH+v9MBWqB7PeqDn9FcIT//kcitUn6kHOu/T/xfWzlQy3dEHhwAAAABJRU5ErkJggg==)](https://discord.blitzjs.com/)[![](https://img.shields.io/badge/all_contributors-403-17BB8A.svg?style=for-the-badge&labelColor=000000)](https://npmcn.com/package/%40blitzjs/rpc/#readme-contributors-) [![](https://img.shields.io/npm/l/blitz.svg?style=for-the-badge&labelColor=000000&color=blue) ](https://github.com/blitz-js/blitz/blob/main/LICENSE)[![](https://img.shields.io/npm/v/blitz.svg?style=for-the-badge&labelColor=000000&color=E65528)](https://www.npmjs.com/package/@blitzjs/auth)

  

# Blitz "零-API" 数据层( Blitz RPC)

  

### [文档链接](https://blitzjs.com/docs/rpc-overview)

### [GitHub 链接](https://github.com/blitz-js/blitz/tree/main/packages/blitz-rpc)

### 快速启动

#### 安装 Blitz RPC

```bash
`npm i @blitzjs/rpc`
# yarn add @blitzjs/rpc
# pnpm add @blitzjs/rpc
```

_也可以选择使用 [`npx`](https://www.npmjs.com/package/npx)_

### 概览

Blitz"Zero-API"数据层(Blitz RPC)专注于使服务器与客户端之间的通信无缝. 它让你

将服务器代码直接导入到您的组件中, 而不是需要手动添加 API 端点并进行客户端取取取和缓存 . 以下是一个简短的概述:

![Blitz RPC Overview](https://blitzjs.com/img/architecture-alt.png)

#### 查询和变异

查询和突变只运行在服务器上——在构建时间,直接函数导入被替换为RPC网络调用. 因此查询功能代码从未包含在您的客户端代码中. 取而代之被移动到API层.

### 框架支助

目前Blitz RPC只在Next.js中支持. 我们正在努力增加对其他框架的支持.

### [在 Next.js 中设置 Blitz RPC](https://blitzjs.com/docs/rpc-setup)

## 常见问题

### 如何安装 @blitzjs/rpc？

在项目目录运行 npm install @blitzjs/rpc，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@tanstack/query-core（5\.51\.1）、blitz（3\.0\.2）、next（\*）、react（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @blitzjs/rpc 支持 TypeScript 吗？

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

### @blitzjs/rpc 支持 ESM 还是 CommonJS？

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

### @blitzjs/rpc 可以商用吗？

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

### @blitzjs/rpc 的下载量有多少？

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

### @blitzjs/rpc 还在维护吗？

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