你知道怎么用 pnpm 临时给某个库打补丁吗？

2025年9月12日 21:59

在使用 pnpm 时，如果你需要为某个依赖包打 patch，可以使用 pnpm 提供的 patch 命令。以下是具体步骤：

pnpm 提供了一个内置的 patch 命令，可以方便地为依赖包创建和应用 patch。步骤如下：

运行 pnpm patch 命令：假设你要给某个包（例如 some-package@1.0.0）打 patch，运行以下命令：
```
pnpm patch some-package@1.0.0
```
- some-package 是你要修改的包名。
- @1.0.0 是具体的版本号（可选，如果不指定，pnpm 会使用当前项目中安装的版本）。
运行后，pnpm 会在你的项目中创建一个临时的目录（通常在 node_modules/.pnpm/patch 下），包含目标包的源代码副本。
修改代码：
- pnpm 会告诉你临时目录的路径（例如 /path/to/tmp/some-package）。
- 打开这个目录，找到需要修改的文件，进行更改。
生成 patch 文件：修改完成后，运行以下命令生成 patch 文件：
```
pnpm patch-commit /path/to/tmp/some-package
```
- /path/to/tmp/some-package 是上一步中 pnpm patch 提示的临时目录路径。
- 执行后，pnpm 会自动生成一个 patch 文件（通常位于 patches/some-package@1.0.0.patch）。
应用 patch：
- 生成的 patch 文件会自动被 pnpm 识别。
- 下次运行 pnpm install 时，pnpm 会自动应用这个 patch 到对应的依赖包。
验证：
- 运行 pnpm install 或检查 node_modules/some-package 中的代码，确认 patch 已正确应用。

如果你更喜欢手动管理 patch 文件，也可以直接创建一个 patch 文件并配置 pnpm 使用它。

复制依赖包的源代码：
- 找到 node_modules/some-package 中的代码，复制到本地某个目录（例如 my-patches/some-package）。
- 修改这个目录中的代码。
生成 patch 文件：使用 diff 工具生成 patch 文件。例如：
```
diff -ru node_modules/some-package my-patches/some-package > patches/some-package@1.0.0.patch
```
- node_modules/some-package 是原始依赖包的目录。
- my-patches/some-package 是你修改后的代码目录。
- patches/some-package@1.0.0.patch 是生成的 patch 文件。

配置 package.json：在项目的 package.json 中，添加 pnpm.patchedDependencies 字段，指定 patch 文件：

{
  "pnpm": {
    "patchedDependencies": {
      "some-package@1.0.0": "patches/some-package@1.0.0.patch"
    }
  }
}

应用 patch：运行以下命令以应用 patch：
```
pnpm install
```
pnpm 会根据 package.json 中的配置，自动应用指定的 patch 文件。

Patch 文件位置：默认情况下，patch 文件存储在项目根目录下的 patches 文件夹中。确保文件夹存在，或者在 package.json 中正确指定路径。
版本匹配：patch 文件是针对特定版本的包（例如 some-package@1.0.0）。如果依赖包的版本升级，patch 文件可能需要更新。
清理临时文件：使用 pnpm patch 时，临时目录在 patch-commit 后会自动清理。如果手动操作，确保不要误删有用文件。
提交 patch 文件：将 patches 目录和 package.json 中的配置提交到版本控制系统（如 Git），以确保团队其他成员也能应用相同的 patch。

假设你要给 axios@1.6.0 打 patch：

Q: 如果 patch 失败怎么办？
- 检查 patch 文件是否与目标包的版本匹配。
- 确保 patch 文件的格式正确（可以用 git apply --check patches/some-package@1.0.0.patch 测试）。
- 查看 pnpm 的错误日志，确认是否有路径或权限问题。
Q: 如何删除 patch？
- 删除 patches 目录中的对应 patch 文件。
- 从 package.json 的 pnpm.patchedDependencies 中移除相关配置。
- 运行 pnpm install 重新安装依赖。

如果有其他问题，请随时告诉我！

阅读视图