用途:.NET 10 SDK 的基于文件应用允许在单个 .cs 文件中构建、运行和发布 C# 应用,无需创建 .csproj,SDK 会依据源码中的 #: 指令自动生成项目配置,适合脚本、工具和小型应用。注意这不是文件 I/O,FileStream、RandomAccess、FileSystemWatcher 与路径处理属于另一主题。
主要能力:支持四类 #: 指令,且必须位于文件顶部、任何 C# 代码之前。#:package 添加 NuGet 包引用(如 #:package Serilog@3.1.1,@* 表示最新稳定版,无版本仅在配置了中央包管理时可用);#:sdk 指定 SDK(默认 Microsoft.NET.Sdk);#:property 设置 MSBuild 属性,支持属性函数与条件表达式;#:project 引用其他项目文件。
使用方式:运行可用 dotnet run app.cs、dotnet run --file app.cs、dotnet app.cs,参数放在 -- 之后;也可从标准输入读取代码:echo 'Console.WriteLine("hello");' | dotnet run -。构建用 dotnet build app.cs,清理用 dotnet clean app.cs 或 dotnet clean file-based-apps,发布用 dotnet publish app.cs,打包为工具用 dotnet pack app.cs,还原用 dotnet restore app.cs。Unix 下可加 shebang 直接执行,但需 LF 换行且无 BOM。支持启动配置文件与用户机密。
默认行为与迁移:基于文件应用默认启用原生 AOT 和 PackAsTool,构建输出在系统临时目录,发布输出在 .cs 文件旁的 artifacts 目录。可用 dotnet project convert app.cs 自动转换为传统项目。
限制:需要 .NET 10 SDK 或更高版本;dotnet test 不适用于基于文件应用;不要将其放在 .csproj 项目目录树内;并发运行同一文件可能产生构建争用,建议先 dotnet build 再以 --no-build 运行;隐式构建文件变更可能不触发重建。其余细节暂未提供。