你可能錯過的 .NET System.IO.Path 函式

每位老司機，對常見程式演算需求多半有自己一套方法，兵來將擋，水來土掩，行之有年。甚至有些寫法在 VBScript 時代習得，之後搬到 JavaScript 用過，到了 .NET 稍調語法繼續發光發熱。舉個例子，在處理檔案路徑時，有時要判斷相對路徑或絕對路徑做不同處理，我慣用的解法是寫個 IsAbsolutePath 之類的函式，判斷路徑最前方是否為 X:\ 磁碟機代號、\\server-name\... UNC 格式來決定。類似這樣：

這其實也沒什麼不對，同樣邏輯上線跑了近二十年沒出過差錯。不過，當知道在 .NET 可以不用自己寫函式判斷，系統有內建 (System.IO.Path.IsPathRooted()) 而且從 .NET 1.1 就有，就覺得自己耍笨了。

這篇來整理大家可能錯過的 System.IO.Path 好用函式：

1. 組裝路徑
   不要再 "C:\Temp" + fileName 串字串了，Path.Combine(folderName, fileName) 能識別多餘 \ 結尾，處理絕對路徑，還能一次串接多節目錄：

   Path.Combine("C:\\Temp", "test.txt"); // C:\Temp\test.txt
   Path.Combine("C:\\Temp\\", "test.txt"); // C:\Temp\test.txt
   Path.Combine("C:\\Temp\\", "2022", "test.txt"); // C:\Temp\2022\test.txt
   Path.Combine("C:\\Temp\\", @"\Workspace", "test.txt"); // \Workspace\test.txt
   

2. 取得目錄、檔名、副檔名
   不要傻傻用 Split('\\')、Split('.') 自己拆，不管目錄、檔名、副檔名都有現成函式

   Path.GetDirectoryName(@"C:\Temp\2022\test.txt"); // C:\Temp\2022
   Path.GetDirectoryName(@"\Temp\test.txt"); // \Temp
   Path.GetFileName(@"\Temp\test.txt"); // test.txt
   Path.GetFileNameWithoutExtension(@"C:\Temp\2022\test.txt"); // test
   Path.GetExtension(@"C:\Temp\2022\test.txt"); // .txt
   

3. 取得完整路徑
   可會依目前所在目錄計算絕對路徑

   Path.GetFullPath(@".\test.txt"); // 由目前工作目錄計算絕對路徑
   Path.GetFullPath(@"C:\Temp\test.txt") // C:\Temp\test.txt
   

4. 檢查路徑是否為從根目錄起始(絕對路徑)

   Path.IsPathRooted(@"C:\Temp"); // true
   Path.IsPathRooted(@"\Temp"); // true
   Path.IsPathRooted(@".\test.txt"); // false
   

5. 取得根目錄

   Path.GetPathRoot(@"Temp\test.txt"); // 空字串
   Path.GetPathRoot(@"\Temp\test.txt"); // \
   Path.GetPathRoot(@"C:\Temp\test.txt"); // C:\
   Path.GetPathRoot(@"\\my-server\share\folder1\test.txt"); // \\my-server\share
   

6. 更換副檔名

   Path.ChangeExtension(@"C:\Temp\test.txt", ".jpg"); // C:\Temp\test.jpg
   

7. 取得暫存目錄、暫存檔名(隨機產生且不重複)

   Path.GetTempPath(); // 例：C:\Users\Jeffrey\AppData\Local\Temp\
   Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString()); // 可拋式暫存檔
   Path.GetTempFileName(); // 不重複隨機檔名，如：C:\Users\Jeffrey\AppData\Local\Temp\tmpB913.tmp
   

8. 檢查路徑或檔名是否包含無效字元

   @"C:\Temp\".IndexOfAny(Path.GetInvalidPathChars()); // -1
   @"C:\?Temp""\".IndexOfAny(Path.GetInvalidPathChars()); // 8, ? 合法 " 不合法
   @"test?.txt".IndexOfAny(Path.GetInvalidFileNameChars()); // 4
   

   順便列出無效路徑與無效檔名字元，無效檔名再多了 :、*、?、\，/ 五個字元

使用 Path 函式的另一大好處是確保跨平台，升級至 .NET Core / .NET 5+，程式有可能是在 Linux/macOS 執行，光路徑分隔符號就跟 Windows 就不一樣，寫死 outputFolder + "\" + subFolderName + "\test.txt 在非 Winodws 平台肯定爆炸，但 Path.Combine(outputFolder, subFolder, "test.txt") 會依所在平台決定路徑分隔符號，正確又省力。所以，現在就開始養成用 Path 函式處理檔名與路徑的習慣吧!

Introduction to the System.IO.Path functions.