【笨問題】CLI 參數為什麼有時要加 "--"？ POSIX 參數慣例的冷知識

DIR /S D:\TEMP
XCOPY D:\Data E:Data /S /E /H

git merge --no-ff -m "commit message" fix/crash-issue
npm install sax --force
curl -O --insecure --header 'Host: www.example.com' -I https://192.168.1.1/file.html
npx webpack init ./my-app --force --template=default

# .NET SDK
dotnet publish -c Release -r win-x64 --no-self-contained -p:PublishSingleFile=true
# Chocolatey
choco install -y --no-progress git.install
# winget
winget install --id Microsoft.PowerToys --version 0.15.2

# 2023-04-17 01:57 AM by Explorer

作者有些地方解釋得不太正確，這邊給予補充/糾正： 1. 當選項後面可加可不加參數的時候，POSIX 的慣例是選項的字母跟選項的參數中間不得有空格，所以假如文中的-f選項可帶可不帶參數的時候…… -fresult.csv # 這樣寫才是正確的 -f"result.csv" # 這樣寫也正確，shell會自動把引號去除 -f result.csv # 這樣寫的話剖析器會認為-f 不帶參數，無論有沒有"--"區隔。

2. "--" 主要的目的是因應參數有可能以橫線記號開頭，例如以橫線開頭的檔名或是需要指定一個負號數字，範例： mkdir -m755 /root/foo/bar # 這會建立一個 /root/foo/bar 資料夾 mkdir -- -m755 /root/foo/bar # 這會建立兩個資料夾，一個為 -m755（檔名開頭為橫線），另一個為 /root/foo/bar

3. 如果命令選項後面的參數在該命令的規則裡是不可省略的話，選項的字母跟選項參數中間就可有空格，但也可以不用。以git commit 的-m選項為例，-m一定要指定訊息，但下面兩種寫法效果會相同： git commit -m"My message" git commit -m "My message" 寫shell script 的時候會建議使用前面的形式（選項字母跟選項參數中間不加空格）。

# 2023-04-18 03:43 AM by Forger

https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html POSIX.1-2017 因為歷史因素的例外條件：（標準規格為了顧及向下相容性是容許變通的，不過宗旨還是希望未來的應用程式得完群遵守 12.2 語法規範，過去的應用程式就算了，以免破壞既有工具的相容性） 12.1 第 2 點載明，選用性選項 -c option_argument 的 -c 選項 以及 option_argument 選項參數 是用 <blank> 空格分隔，唯一一項例外是當 選項參數 [option_argument] 用方括弧包夾時，這反映了一種狀況，例如 [-f[option_argument]] 的 -f 選項跟 [option_argument] 選項參數 是緊鄰在一起的（沒有用空格分開），用來表示選用性 選項參數；然而，如果是必須性的選項參數，例如 [-c option_argument] 的 option_argument 是緊接著到下一個參數（用空格分開）。依據 12.2 語法規範，如果 選項 跟它的 選項參數 是分開的兩個獨立參數時，選項參數 就不能是選擇性的，所以不能是 [-c [option_argument]] 這樣寫。不過因為歷史因素，有以下幾點例外： 12.1 第 2 點 a 項目，依據 [-c option_argument] 用法格式的描述，依循標準的應用程式，應該把 -c 選項 以及 option_argument 選項參數，用兩個分開的獨立參數表示（也就是要用空格隔開，不能緊鄰在一起）。然而依循標準的實作，也應該允許 選項 跟它的 選項參數 是緊鄰在一起的，不必用空格分隔（也就是容許 [-coption_argument] 或 [-c"option argument"] 假如 選項參數 含有空格字元，雙引號會被 SHELL 移除）。 12.1 第 2 點 b 項目，依據 [-f[option_argument]] 用法格式的描述，依循標準的應用程式，應該把 -f 選項 以及 [option_argument] 選項參數，緊鄰的擺放在一起，不必用空格分隔。如果指令參數只有提供 -f 選項，則按照用法格式的描述，視為省略了 [option_argument] 選項參數；並且不能將緊接著的下一個參數，當成是 [option_argument] 選項參數。（也就是說不會有 [-f [option_argument]] 的情況發生，例如 -f ABC 的 -f 選項省略了 選項參數，而不是把 ABC 當作是 -f 選項的 [option_argument] 選項參數） 結論：規範不是盲目遵循，例如規則說不能怎樣，就不能做，那就類似程式語言當中的 Strict 嚴謹模式，但規範中有提到例外，也就是容許變通，不表示這樣做出來的應用程式，就沒有達到依循標準的目的。因此，用法格式的描述 [-c option_argument] 這樣寫，就表示你要 -cXXXX 或是 -c XXXX (用空格隔開)，都是合法的。但是 [-f[option_argument]] 就不能這麼隨興，只能 -fXXXX 這樣使用，或是 -f 單獨使用，即便 -f XXXX (用空格隔開) 也當作省略了 [option_argument] 選項參數，而不是將 XXXX 當作是 選項參數。 12.2 語法規範 第 4 點，所有選項應該用 - 減號開頭。 12.2 語法規範 第 5 點，一般選項，例如 [-a][-b][-d|-e] 選項，不含有 option_argument 選項參數 的 選項，在使用一或多個此類選項時，最後一個選項可以緊接著另一個帶有 option_argument 選項參數 的 選項，只能有這麼一個參數在，那麼這些選項將能夠被接受並作為群組合併在一起，並且開頭只有一個 - 減號。 （也就是說 -a -b -d -c XXXX 一起用，可以簡化為 -abdc XXXX，而不能 -abcd XXXX 這樣使用，-c 的 c 選項只能在群組內最後一個選項，因為 -d 並沒有 option_argument 選項參數） 範例指令：netstat -nlp、tar -cvvf file.tar、git clean -xdf。 12.2 語法規範 第 10 點，第一個遇到的 -- 兩個減號 參數，如果不是 option_argument 選項參數，那它就是 選項 解析的終止條件。（換句話說 -c -- -- -? 第一個 -- 被當成是 -c 選項的 選項參數，第二個 -- 才是終止條件，-? 不視為是選項） 長參數、短參數：長參數 開頭有兩個減號，例如 [--file option_argument]，反之，一般選項只有一個減號，就是 短參數，例如 [-f]。在正式常用的 Linux 工具，像是 man tar 查詢 tar 指令的說明文件，裡面會列出 -f, --file=ARCHIVE 這樣的描述，-f 短參數，--file=長參數檔名。然而 長參數 的 選項參數 不見得要用 = 分隔，也可以用空格分隔，雖然說明文件沒有這樣寫，但是可以這樣用。 此外，像是指令 cd - 或 su -，它們的 - 減號 是程式自己定義的，man su 說明文件的定義則是 -, -l, --login，而 ~ 這個家目錄的符號是 SHELL 定義的。像本篇的 -- 兩個減號，也是 SHELL 定義出來的功能。 12.2 語法規範 第 13 點，像是 tar | gzip - 或 echo -n '計算雜湊值，結尾不含換行' | sha256sum - 則表示從標準輸入的管線讀取內容，sha256sum 不加上 - 減號 效果相同。 12.2 語法規範 第 14 點，如果從第 3 點到第 10 點能夠判斷出這個參數是屬於選項的話，並且如果是選項群組的話，那麼它們即便沒有在開頭加上 - 減號，也是合法的選項規則。 （這也就是為什麼 tar cvvf file.tar 或 ps aux 也能運作的原因，即便不符合 第 4 點 規範，沒在開頭加上 - 減號） https://learn.microsoft.com/en-us/dotnet/standard/commandline/get-started-tutorial https://www.nuget.org/packages/System.CommandLine 微軟官方的教學，使用此套件完美實現 Linux 以上所有長參數、短參數功能，微軟自己的 .NET CLI 也是使用此套件，命令提示字元並沒有 -- 兩個減號的機制，所以 dotnet run -- --file scl.runtimeconfig.json 是模擬出來的。 以上是從 Windows 平台，跨越到 Linux 平台 所必備的基本知識。