@fuman/build

中文文档
0.0.23发布于 2026/10/21MITTypeScriptES Module构建来源已验证近 30 天下载 1988

用于构建软件包和管理单重机的设备

中文使用文档
文档目录7 节
  1. @fuman/ 建设
  2. 为什么?
  3. package.json 预处理功能
  4. 使用 vite 时的用法
  5. 使用 jsr
  6. 语气
  7. 预算外/cd

@fuman/ 建设

这个软件包包含用于构建软件包和管理单体的公用事业.

现有的类似工具试图做太多,并且与每个可能的使用案例一致, 这使得它们很难使用 并且不能提供足够的一致性. 不像他们,这个软件包 非常喜欢 有意见的,也许不适合你.

这个软件包基于一些假设,可以抽象出一些复杂之处:

  • 对于工作空间,它假设工作空间由 pnpm 管理
    • 工作空间内的软件包使用 workspace: 协议, (中文(简体) ), 和版本在构建时替换为实际版本
  • 软件包使用 vite(即滚动) 构建。 我可能会支持其他的 捆绑者下来,虽然
    • tsc是明确的 没有 支持,因为使用 tsc 建设是那么痛苦, 它只是不值得.
  • 所有软件包必须是 type: module,因为 commonjs 烂 (你仍然可以构建为 commonj, tho)
  • .exports 财务报告和审定财务报表 .bin 字段中的字段。json是构建条目,例如:
    {
      "exports": {
        ".": "./src/index.ts"
      },
      "bin": {
        "fuman-build": "./src/cli.ts"
      }
    }
    
  • .main, (中文(简体) ), .module, (中文(简体) ), .types, (中文(简体) ), .browser 明确 没有 已支持。 对于浏览器特定代码,您应该制作一个二级切入点/包,而不是依赖捆绑时间的魔法
  • 软件包的版本是可调和并符合semver要求的(除了“固定版本”的版本,它们都共享同一版本)
  • 此软件包目前侧重于非前端库

这个 可能会 与其他设置一起工作,但不支持.

为什么?

因为节点很烂. package.json 绝对是一团糟——它没有适当地标准化,而且很难合作. 当它被发明时,打字甚至不是一件事情, 因此,为图书馆正确设置它是一种痛苦. 和npm也是一种疼痛 由于类似的原因。 一切都是如此脆弱和不一致,以至于很容易出错.

德诺和jsr解决了一些问题, 但我一般不喜欢德诺,因为它感到非常有限和锁定供应商, 而且没有任何工具 写交叉运行时代码 在deno.

另外,还有相当一些疼痛的写作发布 ci/cd流量为图书馆. 特别是对于单体,特别是当你想跨出 npm 和 jsr 时.

package.json 预处理功能

. 由 processPackageJson 函数

  • 复制根包中的常见字段。 json
  • 替换 workspace: 与工作空间实际版本的依赖关系
  • 删除 scripts (除列于 keepScripts(中文(简体) )
  • 删除 devDependencies, (中文(简体) ), typedoc编号 :prettier/etc 数据
  • 收集从 exports 财务报告和审定财务报表 bin
  • 正在运行的钩子声明在 build.config.js 文件

这允许:

  • 简化内包.jsons,使其与根包同步.json
  • 通过不需要手动更新每个软件包中的依赖性版本来简化发行流程
    • (我知道pnpm/yarn 基本上用 workspace: 但我不喜欢用 npm cli 来发布到 npm 之外的东西
  • 保证你不会意外地发布不必要的 prepare编号 :install/etc. 脚本到 npm( 同时将安装大小减少一点)
  • 减少安装大小
  • 改进 dx 通过 经常
    • 您不再需要在导入软件包之前构建软件包, 也无需通过手动提供 .types 发展方面的业务活动
    • 您不再需要同步 vite 构建切入点 package.json 横跨所有软件包( 并意外发布已破损)
  • 因为我们生成一个新的软件包. json, 你可以做几乎所有的修改 生产软件包. json (尽管如此,我们可能还是有 案件不覆盖,你想要更多的控制。). 如果你觉得这应该放在包裹里

使用 vite 时的用法

把这个放进你的 vite.config.js数字 :

import { fumanBuild } from '@fuman/build/vite'

export default {
  plugins: [
    fumanBuild({
      root: __dirname,
      // if you're using `vite-plugin-dts`, make sure to add this option,
      // otherwise additional entrypoints will not have proper types
      // (and DO NOT add this option to the dts plugin itself)
      insertTypesEntry: true,
    }),
  ],
}

使用 jsr

fuman-building也支持jsr 通过能够将 pnpm 工作空间转换为去诺工作空间, ,然后可以通过简单的 deno publish 命令.

生成去诺工作空间,运行 fuman-build jsr gen-deno-workspace。 。 。 .

语气

福曼建有相当酷的cli,通过 fuman-build --help

预算外/cd

福曼的造型也不错 非常喜欢 易于用于CI/CD管道. 一个非常简单的释放流 由fuman 构建和github动作提供动力 可见 这里。 。 。 .

页:1 release 命令基本上结合了一堆其他命令 (即:, bump-version, (中文(简体) ), gen-changelog, (中文(简体) ), publish 财务报告和审定财务报表 jsr 子命令) 并添加一些额外的释放特性(如:git标记和github释放生成),也是在CI/CD管道中使用fuman-building的建议方式.

虽然可以直接使用其他命令,但如果 您需要做一个没有从框中支持的东西.

版本与发布记录

@fuman/build 共发布 21 个版本,首次发布于 2024/12/02;过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.23latest2026/10/2125 天前
0.0.212026/07/164 个月前
0.0.202026/07/034 个月前
0.0.192026/01/259 个月前
0.0.182025/11/2311 个月前
0.0.172025/11/161 年前

关于 @fuman/build 的常见问题

@fuman/build 是什么?

用于构建软件包和管理单重机的设备

如何安装 @fuman/build?

在项目目录运行 npm install @fuman/build,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vite(^5.4.0 || ^6.0.0 || ^7.0.0)、typescript(^5.2.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 fuman-build,可以用 npx fuman-build 直接运行。

@fuman/build 支持 TypeScript 吗?

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

@fuman/build 支持 ESM 还是 CommonJS?

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

@fuman/build 可以商用吗?

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

@fuman/build 的下载量有多少?

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

@fuman/build 还在维护吗?

最新版本 0.0.23 发布于 2026/10/21(25 天前);至今共发布 21 个版本,其中过去 12 个月发布了 5 个;首次发布于 2024/12/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。