C#

public sealed record TaskItem(string Id, string Title, TaskState State);

var label = item.State switch {
    TaskState.Done => "完成",
    TaskState.Todo => "待办",
    _ => "未知"
};

switch expression 配合穷尽分支表达有限状态。

public async Task<string> LoadAsync(Uri uri, CancellationToken ct)
{
    using var response = await http.GetAsync(uri, ct);
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync(ct);
}

库方法接收 CancellationToken 并传给下游；HttpClient 通常复用而非每次新建。

dotnet new sln -n MemoryTools
dotnet new classlib -n MemoryTools.Core -o src/MemoryTools.Core
dotnet new xunit -n MemoryTools.Tests -o tests/MemoryTools.Tests
dotnet sln add src/MemoryTools.Core tests/MemoryTools.Tests

测试项目再通过 dotnet add reference 引用核心项目。

<PropertyGroup>
  <TargetFramework>net10.0</TargetFramework>
  <Nullable>enable</Nullable>
  <ImplicitUsings>enable</ImplicitUsings>
  <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
</PropertyGroup>

示例采用当前 LTS；实际目标框架仍要按部署环境与支持周期选择。

dotnet restore --locked-mode
dotnet build --no-restore
dotnet test --no-build
dotnet publish src/MemoryTools -c Release

locked-mode 需要 packages.lock.json；否则先根据团队策略启用锁文件。

dotnet watch --project src/MemoryTools run

适合开发热重载；生产使用 publish 后产物和固定启动参数。

dotnet add src/MemoryTools package Microsoft.Extensions.Http
dotnet list package --outdated
dotnet list package --vulnerable

升级后阅读变更并运行完整测试；私有源凭据不要写入仓库。

<Project>
  <PropertyGroup><ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally></PropertyGroup>
  <ItemGroup><PackageVersion Include="xunit" Version="2.9.3" /></ItemGroup>
</Project>

放在 Directory.Packages.props；版本仅作结构示例，应跟随当前兼容版本。

[Theory]
[InlineData("2", 2)]
[InlineData(" 5 ", 5)]
public void ParsesCount(string raw, int expected)
{
    Assert.Equal(expected, CountParser.Parse(raw));
}

边界和错误可分别使用 Theory 数据与 Assert.Throws。

dotnet test --logger "console;verbosity=detailed" --collect:"XPlat Code Coverage"

覆盖率用于发现未执行路径，不代表测试质量。

读取异常中的 service type → 检查注册生命周期与构造函数 → 避免 singleton 捕获 scoped 服务 → 为组合根写启动测试。

不要在业务代码里用 ServiceLocator 绕过缺失注册。

全程 await Task；避免 .Result/.Wait() 阻塞；async void 仅事件处理；为 I/O 传递取消和超时。

在库代码和应用代码中保持异步调用链完整。

await using var stream = File.OpenRead(path);
var result = await ParseAsync(stream, cancellationToken);

await using 用于 IAsyncDisposable；GC 不保证及时关闭外部资源。

EF/LINQ 参数化并避免拼 SQL；每个资源操作都做授权；Data Protection 管理敏感令牌；限制请求/上传；生产不回显详细异常。

模型绑定成功只说明格式可解析，不说明调用者有权限或值符合业务规则。