跳至主要內容
版本：8.x

篩選

篩選功能允許您將命令限制為特定的套件子集合。

pnpm 支援豐富多元的選取器語法，可使用名稱或關係選取套件。

選擇器可以透過 --filter (或 -F) 標籤指定選擇器：

pnpm --篩選 <package_selector> <command>

比對​

--篩選 <package_name>​

為了選取一個精確的套件，只需指定它的名稱 (@scope/pkg) 或使用一個樣本來選取一組套件 (@scope/*)。

Examples:

pnpm --篩選 "@babel/core" 測試
pnpm --篩選 "@babel/*" 測試
pnpm --篩選 "*core" 測試

指定套件的範圍是可選的，因此如果找不到 core，--filter=core 將選取 @babel/core。 然而，若工作區具有多個相同名稱的套件 (例如， @babel/core 和 @types/core)，則沒有範圍的篩選器將不選取任何內容。

--filter <package_name>...​

要選取封裝及其相依性 (直接和非直接)，請在 封裝名稱後綴上省略符號： <封裝名稱>...。 例如，下一個 命令將執行 foo 及其所有相依性的測試：

pnpm --filter foo... test

您可以使用模式來選擇一組根封裝:

pnpm --filter "@babel/preset-*..." test

--filter <封裝名稱>^...​

若要僅選取封裝的相依項 (直接和非直接)， 請以前述的省略符號搭配＞形箭號作為名稱尾碼。 例如， 下一個命令將執行所有 foo 的相依性測試:

pnpm --filter "foo^..." test

--filter ...<封裝名稱>​

要選取封裝及其相依性封裝 (直接和非直接)，請將省略符號作為 封裝名稱首碼: ...<package_name>。 例如，這將 執行 foo 以及其所有相依封裝的測試:

pnpm --filter ...foo test

--filter "...^<封裝名稱>"​

若要僅選擇封裝的相依項 (直接和非直接)，請以省略符號之後跟隨＞形箭號 作為封裝名稱首碼。 例如，這將 為所有相依於 foo 的封裝執行測試：

pnpm --filter "...^foo" test

--filter ./<glob>, --filter {<glob>}​

相對於當前工作目錄相符專案的 Glob 模式。

pnpm --filter "./packages/**" <cmd>

包括指定目錄下的所有專案。

也可以與省略符號和＞形符號運算子一起使用，以選取 依存項/相依項:

pnpm --filter ...{<directory>} <cmd>
pnpm --filter {<directory>}... <cmd>
pnpm --filter ...{<directory>}... <cmd>

它也可以與 [<since>] 結合使用。 例如，要選取目錄中所有已變更的 專案:

pnpm --filter "{packages/**}[origin/master]" <cmd>
pnpm --filter "...{packages/**}[origin/master]" <cmd>
pnpm --filter "{packages/**}[origin/master]..." <cmd>
pnpm --filter "...{packages/**}[origin/master]..." <cmd>

或者，您可以從名稱與給定 模式相符的目錄中選取所有封裝:

pnpm --filter "@babel/*{components/**}" <cmd>
pnpm --filter "@babel/*{components/**}[origin/master]" <cmd>
pnpm --filter "...@babel/*{components/**}[origin/master]" <cmd>

--filter "[<since>]"​

選取自指定認可/分支變更的所有封裝。 也可以在前綴或後綴加上 ... 來包含依賴與被依賴套件。

例如，下方指令將執行來自 master 所有變更的套件與其依賴套件的測試：

pnpm --filter "...[origin/master]" test

--fail-if-no-match​

Added in: v8.13.1

Use this flag if you want the CLI to fail if no packages have matched the filters.

排除​

任何篩選器規則都可以執行排除操作，只需在前綴加上 "！"。 在 zsh (可能還有其他的 shells)，"！" 應被轉譯為 \!。

例如，這將會排除所有專案中的 foo 下執行指令：

pnpm --filter=!foo <cmd>

而這將會排除所有專案中 lib 目錄下的內容執行指令：

pnpm --filter=!./lib <cmd>

使用多個篩選器​

當套件被篩選後，所有的套件都會匹配至少一個篩選器。 您可以同時使用多個篩選器：

pnpm --filter ...foo --filter bar --filter baz... test

--filter-prod <filtering_pattern>​

從工作區中選擇依賴專案時，會忽略 devDependencies 且其餘行為將與 --filter 相同。

--test-pattern <glob>​

test-pattern 允許檢測修改後的檔案是否與測試有關。 如果是，此被修改套件的被依賴套件將不會被包含在內。

此選項對 "changed since" 篩選器很有用。 例如，下方指令將在所有變更中的套件執行測試，若變更在套件的原始碼當中，測試也經在其被依賴的套件中執行：

pnpm --filter="...[origin/master]" --test-pattern="test/*" test

--changed-files-ignore-pattern <glob>​

允許在篩選自指定的提交/分支變更的專案中，通過 glob 樣本需略變更的檔案。

使用範例：

pnpm --filter="...[origin/master]" --changed-files-ignore-pattern="**/README.md" run build