# @commerce-klaus/sfcc-module-resolver 中文文档

规范地址：https://npmcn.com/package/%40commerce-klaus/sfcc-module-resolver/

版本：2\.2\.0
npm 元数据更新时间：2026-10-30T09:10:01.105Z
中文译文更新时间：2026-11-10T13:03:28.751Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40commerce-klaus/sfcc-module-resolver
原文对照：https://npmcn.com/package/%40commerce-klaus/sfcc-module-resolver/?lang=original
项目主页：https://commerce-klaus.github.io/commerce-klaus/packages/sfcc-module-resolver/
源码仓库：https://github.com/commerce-klaus/commerce-klaus

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

- 包体积（解压后）：226 kB，52 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-07-10T10:49:09.097Z
- 最新版本发布：2026-10-30T09:10:00.684Z
- 近 30 天下载量：2607（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

共享 SFCC 墨盒路径和模块解析工具

## 安装

```sh
npm install @commerce-klaus/sfcc-module-resolver
```

也可以使用：`pnpm add @commerce-klaus/sfcc-module-resolver`、`yarn add @commerce-klaus/sfcc-module-resolver`、`bun add @commerce-klaus/sfcc-module-resolver`

## README

[![NPM version](https://badgen.net/npm/v/@commerce-klaus/sfcc-module-resolver)](https://www.npmjs.com/package/@commerce-klaus/sfcc-module-resolver) [![Downloads](https://badgen.net/npm/dw/@commerce-klaus/sfcc-module-resolver)](https://www.npmjs.com/package/@commerce-klaus/sfcc-module-resolver)

# @ commerce-klaus/ sfcc-module-resolver (商业-克劳斯语)

用于SFCC弹匣订单、模块分辨率、超级模块和钩子注册的共享节点.js公用事业。 大多数项目通过Commerce Klaus ESLint,TypeScript,Vite,或Babel包间接使用.

## 要点

-   从配置、环境、, `jsconfig`,或 `site.xml`
-   解释哪些弹匣命令源获胜, 包括缺少条目和无效倒置
-   决定: `*/`, (中文(简体) ), `~/`,弹匣别名,以及 `module.superModule`
-   用每一个尝试的文件路径和选中的匹配来解释解析
-   为 SFCC 认知工具提供决定性文件系统帮助
-   将网站元数据中的自定义属性和首选定义规范化
-   读取并解决弹匣钩注册
-   以墨盒路径顺序发现有效的钩脚本
-   读取工作步骤定义、参数、状态代码、执行能力和任务超时 `steptypes.json`
-   验证带有结构化诊断的钩子、工作步骤和定制API合同
-   构建弹匣优先级、超级模块、 SRA 控制器的决定性项目图表 路线、有效的中间软件管道和元数据合同

`ModuleResolutionOptions` 是 Vite 使用的共享配置类型 还有维特适配器. `ResolveCartridgeRootsOptions` 以 仅解析器 `containingFile` 选项.

项目可在 `commerce-klaus.config.ts` 或者说 `commerce-klaus.config.js`。软件包选项继续得到支持并覆盖 核心价值观。 公共配置合同居住在 `@commerce-klaus/config`; 见 [项目配置指南](https://commerce-klaus.github.io/commerce-klaus/guide/project-configuration)。 。 。 .

## 安装

```bash
pnpm add @commerce-klaus/sfcc-module-resolver
```

```bash
npm install @commerce-klaus/sfcc-module-resolver
```

```bash
yarn add @commerce-klaus/sfcc-module-resolver
```

```bash
vp install @commerce-klaus/sfcc-module-resolver
```

```ts
import {
  createModuleResolver,
  explainCartridgeOrder,
  inferCartridgeOrder,
} from "@commerce-klaus/sfcc-module-resolver/resolution"

const cartridgeRoots = inferCartridgeOrder({ cartridgesDir: "cartridges" })
const resolveSfccModule = createModuleResolver(cartridgeRoots)
const orderTrace = explainCartridgeOrder({ cartridgesDir: "cartridges" })
```

这套软件包为 `resolution`, (中文(简体) ), `object-metadata`, (中文(简体) ), `hooks`, (中文(简体) ), `job-steps`, (中文(简体) ), `custom-apis`,以及全项目验证和图表 `project`。软件包根仅包含分辨率 API.

## 文档

见 [完整 API 和分辨率参考](https://commerce-klaus.github.io/commerce-klaus/packages/sfcc-module-resolver/)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @commerce-klaus/sfcc-module-resolver 是什么？

共享 SFCC 墨盒路径和模块解析工具

### 如何安装 @commerce-klaus/sfcc-module-resolver？

在项目目录运行 npm install @commerce-klaus/sfcc-module-resolver，或使用 pnpm add / yarn add / bun add。

### @commerce-klaus/sfcc-module-resolver 支持 TypeScript 吗？

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

### @commerce-klaus/sfcc-module-resolver 支持 ESM 还是 CommonJS？

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

### @commerce-klaus/sfcc-module-resolver 可以商用吗？

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

### @commerce-klaus/sfcc-module-resolver 的下载量有多少？

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

### @commerce-klaus/sfcc-module-resolver 还在维护吗？

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