什么是基于文件的应用

在单个文件中编写代码，并且能够运行。在这方面 python 是课代表。如今 C# 也能做到了。在 .NET 10 中，微软引入了基于文件的应用（File-based Apps）的概念，允许开发者在单个 .cs 文件中编写、运行和构建应用程序。这种方式极大地简化了开发流程，特别适合于快速原型设计、脚本编写和小型工具的开发。

环境要求

得安装 .NET 10 SDK 才能使用基于文件的应用功能。可以通过下面的命令来检查 .net 版本：

dotnet --version

这里应该显示 10.0.0 或更高版本。

上示例

示例1: date-checker.cs 使用标准库的应用

var targetDate = DateTime.Now;

Console.WriteLine("当前时间是: " + targetDate);

Console.WriteLine("当前日期是今年的第 {0} 天", targetDate.DayOfYear);

示例2: sales-data-analyse.cs 依赖第三方库的应用

#:property PublishAot=false

#:package CsvHelper@33.0.1

using CsvHelper;

using System.Text.Json;

using System.Globalization;

var json = await File.ReadAllTextAsync("sales_data.json");

var sales = JsonSerializer.Deserialize<List<SaleRecord>>(json);

var topProducts = sales.GroupBy(s => s.Product)

.Select(g => new

{

Product = g.Key,

TotalAmount = g.Sum(s => s.Amount)

})

.OrderByDescending(g => g.TotalAmount)

.Take(10)

.ToList();

using var writer = new StreamWriter("top_products.csv");

using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);

csv.WriteRecords(topProducts);

Console.WriteLine("报告生成成功");

record SaleRecord(string Product, decimal Amount, DateTime Date);

分别使用下面的命令运行这两个示例：

dotnet run .\date-checker.cs

dotnet run .\sales-data-analyse.cs

常用指令

要去使用 #: 开头的指令来配置包、sdk、编译选项。

使用 #:sdk 指令来选择 SDK

默认的SDK是 Microsoft.NET.Sdk，如果需要使用 Microsoft.NET.Sdk.Web 来构建 web 应用，可以使用下面的指令：

#:sdk "Microsoft.NET.Sdk.Web"

使用 #:package 指令来引入第三方库

#:package CsvHelper@33.0.1

#:package CsvHelper@*

#:package CsvHelper@33.*

上面三个版本分别表示使用指定版本、最新版本和指定主版本的库。

使用 #:property 指令设置编译选项

编译属性就是 csproj 文件中的属性，可以使用 #:property 指令来设置：

#:property LangVersion=preview

#:property Nullable=disable

#:property PublishAot=false

#:property TargetFramework=net10.0

使用 #:reference 指令来引用本地程序集

#:reference "path/to/your/library.dll"

使用 #:project 指令来引用本地项目

#:project "path/to/your/project.csproj"

CLI 支持

下面是一些支持基于文件的应用的 CLI 命令：

• dotnet run <file.cs>：运行指定的 .cs 文件。
• dotnet build <file.cs>：构建指定的 .cs 文件。
• dotnet publish <file.cs>：发布指定的 .cs 文件。
• dotnet pack <file.cs>：打包指定的 .cs 文件。
• dotnet project convert <file.cs>：转换指定的 .cs 文件为一个完整的项目。
• dotnet restore <file.cs>：还原指定的 .cs 文件中引用的包。
• dotnet clean <file.cs>：清理指定的 .cs 文件生成的输出。
• dotnet run <file.cs> -- <args>：运行指定的 .cs 文件，并传递额外的命令行参数。