Git 命令中的 <pathspec></pathspec> 參數(shù)：靈活運(yùn)用 Git 的強(qiáng)大功能

在查閱 Git 命令文檔時(shí)，你可能會(huì)注意到許多命令都包含 <pathspec></pathspec> 選項(xiàng)。起初，你可能認(rèn)為這只是“路徑”的一種技術(shù)說法，只能接受目錄和文件名。然而，深入了解后你會(huì)發(fā)現(xiàn)，Git 命令中的 <pathspec></pathspec> 遠(yuǎn)比你想象的強(qiáng)大。

<pathspec></pathspec> 是 Git 用于限制 Git 命令作用范圍的機(jī)制，它將命令的執(zhí)行范圍限定在倉庫的子集。即使你沒有意識(shí)到，你可能已經(jīng)在使用 <pathspec></pathspec> 了。例如，在命令 git add README.md 中，<pathspec></pathspec> 就是 README.md。但 <pathspec></pathspec> 能夠?qū)崿F(xiàn)更精細(xì)、更靈活的操作。

學(xué)習(xí) <pathspec></pathspec> 的好處在于，它能顯著增強(qiáng)許多 Git 命令的功能。例如，使用 git add，你可以只添加單個(gè)目錄中的文件；使用 git diff，你可以檢查僅對擴(kuò)展名為 .scss 的文件名所做的更改；你還可以使用 git grep 搜索所有文件，但排除 /dist 目錄中的文件。

此外，<pathspec></pathspec> 有助于編寫更通用的 Git 別名。例如，我有一個(gè)名為 git todo 的別名，它將搜索我所有存儲(chǔ)庫文件中的字符串“todo”。但是，我希望它顯示字符串的所有實(shí)例，即使它們不在我的當(dāng)前工作目錄中。使用 <pathspec></pathspec>，我們可以實(shí)現(xiàn)這一點(diǎn)。

文件或目錄

使用 <pathspec></pathspec> 最直接的方法是使用目錄和/或文件名。例如，使用 git add，你可以執(zhí)行以下操作：.、src/ 和 README 分別是每個(gè)命令的 <pathspec></pathspec>。

git add .      # 添加當(dāng)前工作目錄 (CWD)
git add src/   # 添加 src/ 目錄
git add README # 只添加 README 文件

你也可以向一個(gè)命令添加多個(gè) <pathspec></pathspec>：

git add src/ server/ # 添加 src/ 和 server/ 目錄

有時(shí)，你可能會(huì)看到命令的 <pathspec></pathspec> 前面有一個(gè) --。這是用來消除 <pathspec></pathspec> 和命令其他部分之間歧義的。

通配符

除了文件和目錄外，你還可以使用 *、? 和 [] 來匹配模式。* 符號用作通配符，它將匹配路徑中的 / —— 換句話說，它將搜索子目錄。

git log '*.js' # 記錄 CWD 和子目錄中的所有 .js 文件
git log '.*'   # 記錄 CWD 中所有“隱藏”文件和目錄
git log '*/.*' # 記錄子目錄中所有“隱藏”文件和目錄

引號非常重要，尤其是在使用 * 時(shí)。它們可以防止你的 shell（例如 bash 或 ZSH）自行擴(kuò)展通配符。例如，讓我們看看 git ls-files 如何在使用和不使用引號的情況下列出文件。

# 示例目錄結(jié)構(gòu)
#
# .
# ├── package-lock.json
# ├── package.json
# └── data
#     ├── bar.json
#     ├── baz.json
#     └── foo.json

git ls-files *.json

# package-lock.json
# package.json

git ls-files '*.json'

# data/bar.json
# data/baz.json
# data/foo.json
# package-lock.json
# package.json

由于 shell 在第一個(gè)命令中擴(kuò)展了 *，git ls-files 收到的命令是 git ls-files package-lock.json package.json。引號確保 Git 是擴(kuò)展通配符的一方。

你還可以使用 ? 字符作為單個(gè)字符的通配符。例如，要匹配 mp3 或 mp4 文件，你可以執(zhí)行以下操作。

git ls-files '*.mp?'

方括號表達(dá)式

你還可以使用“方括號表達(dá)式”來匹配集合中的單個(gè)字符。例如，如果你想匹配 TypeScript 或 JavaScript 文件，可以使用 [tj]。這將匹配 t 或 j。

git ls-files '*.[tj]s'

這將匹配 .ts 文件或 .js 文件。除了使用字符外，還可以引用方括號表達(dá)式中某些字符集合。例如，你可以在方括號表達(dá)式中使用 [:digit:] 來匹配任何十進(jìn)制數(shù)字，或者使用 [:space:] 來匹配任何空格字符。

git ls-files '*.mp[[:digit:]]' # mp0, mp1, mp2, mp3, ..., mp9
git ls-files '*[[:space:]]*' # 匹配包含空格的任何路徑

要了解更多關(guān)于方括號表達(dá)式及其使用方法的信息，請查看 GNU 手冊。

魔法簽名

<pathspec></pathspec> 還擁有名為“魔法簽名”的特殊工具，它可以為你的 <pathspec></pathspec> 解鎖一些額外的功能。這些“魔法簽名”是通過在 <pathspec></pathspec> 的開頭使用 :(signature) 來調(diào)用的。如果不明白，別擔(dān)心：一些例子應(yīng)該會(huì)有所幫助。

top

top 簽名告訴 Git 從 Git 倉庫的根目錄而不是當(dāng)前工作目錄匹配模式。你也可以使用簡寫 / 而不是 :(top)。

git ls-files ':(top)*.js'
git ls-files ':/*.js' # 簡寫

這將列出倉庫中所有擴(kuò)展名為 .js 的文件。使用 top 簽名，這可以在倉庫中的任何子目錄中調(diào)用。我發(fā)現(xiàn)這在編寫通用的 Git 別名時(shí)特別有用！

git config --global alias.js 'ls-files -- ':(top)*.js''

你可以使用 git js 在你的倉庫中的任何位置獲取項(xiàng)目中所有 JavaScript 文件的列表。

icase

icase 簽名告訴 Git 在匹配時(shí)忽略大小寫。如果你不關(guān)心文件名的大小寫，這將非常有用——例如，這對于匹配 jpg 文件非常有用，jpg 文件有時(shí)使用大寫擴(kuò)展名 JPG。

git ls-files ':(icase)*.jpg'

literal

literal 簽名告訴 Git 按字面意思對待所有字符。如果你想將 * 和 ? 等字符作為其本身而不是通配符來對待，則可以使用此選項(xiàng)。除非你的倉庫的文件名包含 * 或 ?，否則我不認(rèn)為這個(gè)簽名會(huì)被經(jīng)常使用。

git log ':(literal)*.js' # 返回文件 '*.js' 的日志

glob

當(dāng)我開始學(xué)習(xí) <pathspec></pathspec> 時(shí)，我注意到通配符的工作方式與我習(xí)慣的不同。通常，我看到單個(gè)星號 * 作為不匹配目錄中任何內(nèi)容的通配符，而連續(xù)星號 (**) 作為“深度”通配符，將匹配目錄中的名稱。如果你更喜歡這種風(fēng)格的通配符，你可以使用 glob 魔法簽名！

如果你想更精細(xì)地控制搜索項(xiàng)目目錄結(jié)構(gòu)的方式，這將非常有用。例如，讓我們看看這兩個(gè) git ls-files 如何搜索 React 項(xiàng)目。

git ls-files ':(glob)src/components/*/*.jsx' # “頂級”jsx 組件
git ls-files ':(glob)src/components/**/*.jsx' # “所有”jsx 組件

attr

Git 能夠?yàn)樘囟ㄎ募O(shè)置“屬性”。你可以使用 .gitattributes 文件設(shè)置這些屬性。

<code># .gitattributes

src/components/vendor/*  vendored # 設(shè)置“vendored”屬性
src/styles/vendor/*      vendored</code>

使用 attr 魔法簽名可以為你的 <pathspec></pathspec> 設(shè)置屬性要求。例如，我們可能希望忽略來自供應(yīng)商的上述文件。

git ls-files ':(attr:!vendored)*.js' # 搜索非 vendored 的 js 文件
git ls-files ':(attr:vendored)*.js'  # 搜索 vendored 的 js 文件

exclude

最后，是“exclude”魔法簽名（簡寫為 :! 或 :^）。此簽名的工作方式與其他魔法簽名不同。在解析所有其他 <pathspec></pathspec> 后，將解析所有帶有 exclude 簽名的 <pathspec></pathspec>，然后將其移除返回的路徑。例如，你可以搜索所有 .js 文件，同時(shí)排除 .spec.js 測試文件。

git grep 'foo' -- '*.js' ':(exclude)*.spec.js' # 搜索 .js 文件，排除 .spec.js
git grep 'foo' -- '*.js' ':!*.spec.js' .       # 與上述相同的簡寫

組合簽名

沒有什么可以限制你在單個(gè) <pathspec></pathspec> 中使用多個(gè)魔法簽名！你可以在括號內(nèi)用逗號分隔你的魔法詞來使用多個(gè)簽名。例如，如果你想從倉庫的底部（使用 top）、不區(qū)分大小寫（使用 icase）、僅使用已創(chuàng)作的代碼（使用 attr 忽略供應(yīng)商文件）以及使用 glob 風(fēng)格的通配符（使用 glob）進(jìn)行匹配，則可以執(zhí)行以下操作。

git ls-files -- ':(top,icase,glob,attr:!vendored)src/components/*/*.jsx'

你無法組合的兩個(gè)魔法簽名是 glob 和 literal，因?yàn)樗鼈兌紩?huì)影響 Git 處理通配符的方式。這在 Git 詞匯表中提到，也許是我在任何文檔中讀到的最喜歡的句子。

Glob 魔法與 literal 魔法不兼容。

<pathspec></pathspec> 是許多 Git 命令的一個(gè)組成部分，但其靈活性并非立即可見。通過學(xué)習(xí)如何使用通配符和魔法簽名，你可以成倍地提高你在 Git 命令行上的能力。

以上是git Pathspecs以及如何使用它們的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！