.NET SDK 运行时配置：获取文件型应用程序的入口路径

在.NET生态系统中，文件型应用程序（file-based apps）是一种特殊的应用形式，开发者可以直接运行单个C#文件而无需创建完整的项目结构。这种模式在脚本场景下特别有用，但长期以来存在一个痛点：应用程序无法直接获取自身入口文件的路径信息。

背景与挑战

传统上，当开发者使用dotnet run app.cs命令运行文件型应用程序时，应用程序内部无法直接确定正在执行的源文件路径。这与许多脚本语言（如PowerShell的$PSScriptRoot或Python的__file__）形成鲜明对比，这些语言都提供了获取当前执行文件路径的内置机制。

在.NET中，虽然可以通过Environment.CurrentDirectory或Directory.GetCurrentDirectory()获取当前工作目录，但这与入口文件所在目录可能完全不同。这种差异给需要基于入口文件位置进行文件操作的场景带来了不便。

解决方案：运行时配置选项

经过.NET团队深入讨论，最终确定通过运行时配置选项（RuntimeHostConfigurationOption）来解决这个问题，而不是最初考虑的环境变量方案。这种方案具有以下优势：

1. 避免了环境变量污染问题
2. 不依赖于进程间环境继承
3. 提供了更稳定可靠的配置机制

实现细节

在构建文件型应用程序时，SDK会自动生成一个虚拟项目文件，其中包含以下配置：

<ItemGroup>
  <RuntimeHostConfigurationOption Include="EntryPointFilePath" Value="D:\Path\To\File\Based\app.cs" />
  <RuntimeHostConfigurationOption Include="EntryPointFileDirectoryPath" Value="D:\Path\To\File\Based\" />
</ItemGroup>

这些配置会被编译到应用程序的appname.runtimeconfig.json文件中，格式如下：

{
  "runtimeOptions": {
    "configProperties": {
      "EntryPointFilePath": "D:\\Path\\To\\File\\Based\\app.cs",
      "EntryPointFileDirectoryPath": "D:\\Path\\To\\File\\Based\\"
    }
  }
}

在代码中访问路径信息

开发者可以在应用程序中通过AppContextAPI轻松获取这些路径信息：

var scriptFilePath = AppContext.GetData("EntryPointFilePath") as string;
var scriptFileDirPath = AppContext.GetData("EntryPointFileDirectoryPath") as string;

应用场景

这一特性特别适用于以下场景：

1. 脚本工具开发：需要基于脚本位置加载配置或资源文件
2. 自动化任务：需要知道脚本所在目录来执行相关操作
3. 教学示例：简化文件路径处理的演示代码
4. 快速原型开发：在不需要完整项目结构的情况下进行快速验证

总结

.NET SDK的这一改进为文件型应用程序提供了更完整的运行时环境信息，使开发者能够更方便地处理与文件位置相关的操作。通过标准化的运行时配置机制，既保证了功能的可靠性，又提供了简洁的API访问方式，进一步提升了.NET作为脚本语言的可用性。