让开源，少一点语言距离。
npm包中文文档

@coveo/headless-react

中文文档
2.10.5发布于 2026/11/03Apache-2.0ES Module构建来源已验证近 30 天下载 2.6万

React utilities for SSR (Server Side Rendering) with headless

原始使用文档
中文原文

title: Home

Use the Headless React library for Server Side Rendering

@coveo/headless-react provides React utilities for server-side rendering with headless controllers. This package includes several sub-packages:

  • @coveo/headless-react/ssr: For general server-side rendering with headless controllers.
  • @coveo/headless-react/ssr-commerce: (Open Beta) For implementing a commerce storefront with server-side rendering.
  • @coveo/headless-react/ssr-next: For future breaking changes and the latest features related to SSR with React (experimental, subject to change).
  • @coveo/headless-react/ssr-commerce-next: For future breaking changes and the latest features for SSR commerce storefronts (experimental, subject to change).

Learn more

版本与发布记录

@coveo/headless-react 共发布 3,289 个版本，首次发布于 2023/09/25；过去 12 个月发布了 45 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
2.10.5latest2026/11/038 天前
2.10.42026/10/2022 天前
2.10.32026/10/1428 天前
2.10.22026/10/061 个月前
2.10.12026/09/301 个月前
2.10.02026/09/231 个月前

其他发布通道：v2-latest → 1.1.11。

关于 @coveo/headless-react 的常见问题

@coveo/headless-react 是什么？

React utilities for SSR (Server Side Rendering) with headless

如何安装 @coveo/headless-react？

在项目目录运行 npm install @coveo/headless-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18 || ^19）、react-dom（^18 || ^19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@coveo/headless-react 支持 TypeScript 吗？

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

@coveo/headless-react 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@coveo/headless-react 需要什么版本的 Node.js？

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

@coveo/headless-react 可以商用吗？

@coveo/headless-react 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

@coveo/headless-react 的下载量有多少？

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

@coveo/headless-react 还在维护吗？

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