.NET 10 Preview 5 帶來的C# 文件腳本化運行，在 Linux/Unix 系統中通過 #!/usr/bin/dotnet run 支持 Shebang（Hashbang） 的詳細說明：

?? 一、Shebang 的原理與作用

1. 基本定義 Shebang（又稱 Hashbang）是腳本文件開頭的特殊標記，格式為 #!<解釋器路徑>。

• 作用：告知操作系統使用指定程序執行腳本，無需顯式調用解釋器。

• 示例：

#!/usr/bin/dotnet run  # 指定用 dotnet run 執行后續代碼
Console.WriteLine("Hello from C# script!");

2. 運行機制

• 當直接執行腳本（如 ./hello.cs）時，系統讀取首行 Shebang，調用 /usr/bin/dotnet run 解釋文件內容。

• 若未添加可執行權限（chmod +x hello.cs），會報權限錯誤。

二、在 C# 中使用 Shebang 的方法（.NET 10 支持）

步驟詳解

1. 添加 Shebang 聲明 在 C# 文件首行寫入：

#!/usr/bin/dotnet run
Console.WriteLine("Hello, .NET 10!");

2. 賦予可執行權限

chmod +x hello.cs  # 使文件可直接執行

3. 直接運行腳本

./hello.cs  # 輸出：Hello, .NET 10!

關鍵特性

• 無需項目文件：直接運行單個 .cs 文件，無需 .csproj 或編譯步驟。

• 依賴管理：結合文件級指令（如 #:package）引用 NuGet 包：

#!/usr/bin/dotnet run
#:package Humanizer@2.14.1
using Humanizer;
Console.WriteLine(TimeSpan.FromDays(1).Humanize());  // 輸出："1 day"

指令需緊接 Shebang 后聲明。

? 三、實際應用場景

1. 自動化腳本

• 替代 Bash/Python 編寫系統工具（如日志清理、文件備份）：

#!/usr/bin/dotnet run
foreach (var file in Directory.GetFiles("./logs"))
    File.Delete(file);

2. 快速原型驗證

• 直接運行代碼片段驗證邏輯，省去創建項目的開銷。

3. 跨平臺 CLI 工具

• 通過 Shebang 兼容 Linux/macOS，Windows 需通過 dotnet run hello.cs 顯式執行（因 Windows 不支持 Shebang）。

?? 四、注意事項與限制

1. 系統兼容性

• 僅限 Unix/Linux：Shebang 在 Windows 無效，需改用 dotnet run hello.cs。

• 路徑正確性：若 /usr/bin/dotnet 不存在，需調整為實際安裝路徑（如 #!/usr/local/bin/dotnet run）。

2. 文件格式要求

• 首行聲明：Shebang 必須是文件第一行，否則無效。

• 編碼與換行符：文件需保存為 UTF-8 編碼，使用 LF 換行符（Unix 格式）。

3. 當前限制

• 多文件支持：暫不支持跨文件引用（如 partial class），需等待后續更新。

• 調試支持：需轉換為正式項目（dotnet project convert hello.cs）后調試。

五、與傳統執行方式的對比

總結

• 開發者價值： Shebang 支持使 C# 成為真正的腳本語言，降低學習門檻，提升在自動化場景的競爭力，尤其適合 DevOps 和跨平臺工具開發。

• 適用場景：快速驗證、小型工具開發、教學演示。

• 未來展望：多文件支持、Windows 兼容優化（如通過 env 查找路徑）。

提示：通過 .NET 10 SDK 安裝體驗，搭配 VS Code + C# Dev Kit 擴展可獲得完整腳本開發支持。下載地址：https://dotnet.microsoft.com/zh-cn/download