Newshot

Nudeps:类似打包器的导入,却没有那些累赘

Translation(model translation, not the source's own text)

Nudeps:类似打包器的导入,毫无负担

目前,打包器是在不让我们失去理智的前提下使用依赖项的唯一方式,但它们引入了复杂性和开销。今天,我发布一种新型轻量级构建工具,来挑战这一点。

Nudeps 的预告图片。访问链接获取机器可读格式。
Nudeps 的预告图片。访问链接获取机器可读格式。

目标是轻构建,而不是无构建

你 npm install 一个包(例如 vue),编写 import { createApp } from "vue",然后它就能工作——只要中间有一个打包器。没有打包器时,浏览器完全不知道 "vue" 是什么:它只理解 URL,而 node_modules/ 从来就不是用来部署的。因此,即使是最简单的项目,最终也需要一个打包器,仅仅是为了能使用依赖项,而不是重新造轮子。

但打包器会增加显著负担。它们处理每一个文件,在源代码与部署之间引入多层抽象,而这些抽象常常会泄漏:在浏览器中正常工作的东西,可能在构建时坏掉。

今年早些时候,我发表了《Web 依赖已破碎:我们能修复它们吗?》,从平台架构角度讨论了这个问题。除了架构层面的担忧,这种复杂性也是开发者实实在在的痛点:在 State of JS 2025 中,“管理依赖”是第 3 大痛点,“构建工具”是第 6 大痛点。

然而,摆脱构建工具并不是目标。有些用例不应由浏览器处理,因此打包器和构建工具始终会有用武之地。目标是让它们更轻、可组合,并且不那么不可或缺。

沿着这个思路……

Nudeps:让你的依赖“裸奔”(即周围没有打包器)

Nudeps1 你可以选择把它读作 nude deps 或 nu(new)deps,是一种新型轻量级构建工具,它让你继续使用 npm install 管理依赖项,在本地进行 vendor,并通过裸说明符(像 "vue" 或 @floating-ui/dom 这样的包名,而不是 URL)导入它们,而无需打包器。

你只需设置一次,然后就可以忘掉它:你继续用 npm install 安装包,并按名称导入它们,它们就能在浏览器中工作。而且它只会接触你的依赖项,绝不会碰你自己的代码。

自从今年二月我和我的学徒 Dmitry 制作了初始 MVP 原型以来,我们和其他人已在各种项目上测试过它,而此刻我确信——尽管它并不完美——它已经可以投入正式使用了。

Nudeps 与打包器的一个核心架构差异是,你自己的代码保持原样。事实上,它甚至不需要一个在你每次编辑时运行的监视器!它只接触依赖文件,并且不重写任何东西,因此在它增加的复杂性方面极其轻量。

这意味着它可以补充任何其他工具——或者不补充任何工具。你编写原生 HTML、CSS、JS?这就是为你准备的。你使用模板引擎、CSS 预处理器和 TypeScript?这也适合你(不过可以理解,你可能用得较少)。这也使它特别适合补充静态站点生成器和岛屿架构。

它会取代你的构建过程吗?如果你只需要它来让导入工作,那它可以。如果你还要编译代码(JSX、TypeScript、单文件组件),你仍然需要一个工具来做这件事,但它可以小得多。

打包器让复杂的事情成为可能。Nudeps 希望占据曲线左侧的空间,让简单的事情变得容易。

如何使用?

假设你不需要自定义任何东西(例如使用 /importmap.js 作为映射,使用 client_modules/ 存放依赖项,全部使用默认设置),它就是这样使用的:

  • 你运行 npx nudeps install,它会为你设置好一切。
  • 你通过任何你想要的机制,将 <script src="/importmap.js"></script> 添加到 HTML 中,且位于任何其他导入依赖项的脚本之前:

        <script src="/importmap.js"></script>
<script type="module">
	import { createApp } from "vue"; // works!
</script>
      

文章标题:Nudeps:像打包器一样的导入,却没有那些负担

正文: 就是这样。你完成了。现在你可以尽情地 npm install 和 npm uninstall,并立即在代码中使用这些包。东西就是能用™。

我们已经被训练得太习惯摩擦和复杂性,以至于一些测试者以为自己操作错了:

我运行了 npx 命令,把导入映射加到了我的应用里,但我以为还有很多工作要做。当我意识到已经完成时,我震惊了。 — Sam Littlefair

我运行了 npx 命令,把导入映射加到了我的应用里,但我以为还有很多工作要做。当我意识到已经完成时,我震惊了。

— Sam Littlefair

它在底层是如何工作的?

大部分部件早已存在,只是在等待有人把拼图拼起来。

导入映射允许我们在浏览器中导入裸标识符(像 “vue” 这样的包名)而不是 URL,并且已经达到 Baseline 广泛可用。JSPM 是一个库,它追踪依赖图并生成导入映射。它专注于 CDN 用例,但其引擎作为单独的库暴露出来,可以被重新利用,这正是 Nudeps 在底层使用的(做了大量调整)。

导入映射目前必须内联在每个页面的 HTML 中,这需要模板化,但外部导入映射可以通过一个小脚本轻松模拟,该脚本注入映射。

像 npm 这样的包管理器已经提供了文件结构,并让你管理版本控制,只是该结构不能原样部署到 Web 上。

通过 npx nudeps install 安装 Nudeps 会做几件事,最值得注意的是:

  • 将 Nudeps 添加到你的 devDependencies
  • 添加两个运行 npx nudeps 的 package.json 脚本:dependencies,这样每次你 npm install 或 npm uninstall 时 Nudeps 都会重新运行自身;以及 prepare,这样全新克隆的仓库也能就绪。

使用 dependencies 作为钩子意味着当你开始处理项目时,没有 Nudeps 监视器或命令需要运行!从这个意义上说,Nudeps 实际上给你比打包器更好的 DX2当然,如果你需要启动开发服务器,那没什么大区别。但 localhost 很便宜。你的编辑器可以启动一个。你的代理可以启动一个。哎呀,我甚至在所有克隆仓库的根目录下都有一个在运行。 。

然后,每当 npx nudeps 运行时,它会……

  • 将必要的文件从 node_modules/ 复制到 client_modules/ 目录,该目录用于部署,但不提交:它在每次 npm install 时重新生成,并自带 .gitignore
  • 通过在目录名中包含版本号来扁平化目录结构(例如 vue 变成 [email protected]),这为你提供了更好的去重和细粒度缓存失效,
  • 生成一个导入映射注入脚本,包含你直接依赖中的所有标识符以及它们实际使用的标识符,底层使用 JSPM。

以下是该脚本可能的样子示例。

在生产环境中,你可以修剪为仅实际使用的标识符(通过 prune 选项),而在开发环境中包含全部意味着导入映射只需在你的依赖变化时改变,而不是每当你编写导入时。

我能用它做什么?我能用框架吗?

可以!显然有些框架仅编译(例如 Svelte),但许多只有运行时导入。甚至 React 也可以使用,尽管没有 JSX 的人体工学很差。我个人的首选是 Vue。

大多数库也能正常工作,包括 D3、gsap、Lit、Three.js、Floating UI、interact.js 和 Underscore。

除了常见情况,Nudeps 还支持不少边缘情况:

  • 动态 import()
  • import.meta.resolve()
  • 本地包(npm i ../foo)
  • npm 别名(npm i vue2@npm:vue@2)
  • git 依赖(npm i git+https://github.com/foo/bar.git)
  • npm 工作区(实验性)

许多仅 CJS 的包如 lodash 也能工作,通过一个微小的 require() 垫片(Nudeps 会处理),而 jQuery 演示甚至通过 npm 别名并排加载两个不同的 jQuery 版本。

我能使用非 JS 依赖,比如图标库或 CSS 吗?

是的!事实上,这些演示中包含两个这样的依赖:Open Props 和 Bootstrap Icons。

问题在于,浏览器目前无法通过 specifier 引入 CSS 样式表,所以你必须使用实际的 URL(这一点正在改变)。这也意味着这些包不能使用其他依赖(除非它们自己打包进去)。幸运的是,大多数包都是这样。

为了让这件事更容易,Nudeps 会创建符号链接(在不支持符号链接的地方则使用重定向),这样你就可以引入像 client_modules/open-props/ 这样的无版本 URL。

我的 agent 能理解它吗?

从我们测试的一开始(早在二月份),Claude 就完全理解它,只犯了一些没必要但最终无害的小错误(Nudeps 仍然正常工作),例如:

  • 向 .gitignore 添加条目(生成的文件已经会自动忽略自己)
  • 手动运行 npx nudeps、把它添加为 npm run build 脚本,甚至因为以为它是自定义脚本而手动运行 npm run dependencies。它并不知道 dependencies hook(事实上还坚称它不存在 😅)
  • 添加了并不需要的配置文件覆盖

而现在这个包包含了一个 SKILL.md 文件,一旦指示 agent 真正使用它,这些问题就会完全消失。

所有包都能用吗?

大多数包都能用。

  • Nudeps 对 ESM 包的支持要好得多。CJS 支持非常实验性。
  • 有些包不幸地假定自己运行在 Node.js 环境中,并依赖 process.env 这类 Node.js 特有的 API。对于最常见的那些,你直接 stub 掉即可,但如果情况开始失控,最好为那个特定的包使用 bundle(你可以通过 Nudeps 的配置添加覆盖)。

另外,由于 Nudeps 不做打包,那些由大量细小模块通过 ESM 引入拼在一起的包,初次加载可能会更慢。如果你是包作者,想提供一个对 Nudeps 友好的 bundle,生成一个在一定程度上合并它们的 bundle 可以提升性能。但所有打包都有取舍:打包的文件越多,加载的粒度就越粗。通常存在一个最佳平衡点,而这取决于你包的结构和使用模式。但请不要把你这个包的依赖也一起打进去——这些需要保持独立,这样才能与使用同一依赖同一版本的其他包共享。

有什么坑?

Nudeps 只做一件事,所以有些事情它不做,有些事情它还没做:

  • 它不转换你的代码。任何需要编译的东西(JSX、TypeScript、Svelte)仍然需要自己的工具,Nudeps 很乐意与它们共存。
  • 目前仅支持 npm。支持其他包管理器(pnpm、yarn 等)在路线图的最顶部,因为如今很多人已经不再使用 npm。
  • 非 JS 依赖需要实际 URL,而不是 specifier。
  • Workers 也不支持 specifier,见 whatwg/html#8173
  • 还没有基准测试。取决于包的结构和使用类型,打包器可能会明显更快,甚至略慢。能有一些数据会很好。

接下来是什么?

Nudeps 只是开始,还远非完美。肯定有大量未知的未知,也有很多事情我们 simply 还没顾得上。

除了修复 bug 和填补上面的空白,路线图的最顶部是测试更多包,以确保兼容性并发现边缘情况。

试一试!

如果你想试试 Nudeps,最简单的方法是打开终端,在你的项目目录中运行 npx nudeps install —— 或者直接让你的 agent 来做。

获取 Nudeps Demos Nudeps on npm

我希望 Nudeps 是迈向更轻量、可组合构建工具未来的第一步。试一试,并告诉我们效果如何!

Nudeps:类似打包器的导入,毫无包袱

感谢 beta 测试者:@g12n、@jak2k、@lgarron、@beejunk。感谢 Jordan Harband 在包子集化方面的早期反馈。一如既往地感谢我的学徒 Dmitry,他帮助解决了问题并让这成为现实。

  • 你可以选择将其读作 nude deps 或 nu (new) deps ↩︎
  • 当然,如果你需要为开发启动一个服务器,那并没有太大区别。但 localhost 很便宜。你的编辑器可以启动一个。你的 agent 可以启动一个。甚至,我在所有克隆仓库的根目录都有一个在运行。 ↩︎

反响

Bluesky 上的点赞

在 Bluesky 上点赞这篇帖子,就能在此页面看到你的头像

评论

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Lobsters
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗