DDD 中 IEnumerable 和 List 的应用指南

领域层与 WebAPI 不同层的正确序列选择

在日常 DDD / Clean Architecture 项目中，我们常常遇到一个看似简单的问题：

到底应该在不同的层中使用 IEnumerable<T> 还是 List<T>？

很多开发者随手就写了 List<T> 或 IEnumerable<T>，但其实这牵涉到分层设计的底层逻辑：
抽象、契约、可枚举、序列化、安全性、性能、职责边界。

本文将用最简单的方式解释清楚，并附带图示帮助理解。

📌 一张图看懂：为什么不同层要用不同的序列类型？

核心原则：

🧩 为什么领域层应该返回 IEnumerable<T>？

领域层是纯业务逻辑层，应该做到：

• 不依赖具体集合类型
• 不强制一次性加载全部数据
• 能支持延迟枚举（LINQ 查询链式编写更自然）

示例：

public interface ITemplateRepository
{
    IEnumerable<Template> GetAll();
    IEnumerable<Template> FindByCategoryId(int categoryId);
}

注意：不要在 Domain 层返回 List / HashSet / Dictionary，这是具体实现细节，属于泄露基础设施的抽象。

🏗️ 为什么基础设施层返回 IEnumerable 更合适？

比如你用的是 EF Core：

public IEnumerable<Template> GetAll()
{
    return _dbContext.Templates.AsNoTracking();
}

这个返回的是一个可枚举查询，不是立即加载的 List。 基础设施层的职责就是「提供数据」，并且尽可能贴近“抽象化契约”。

🚀 WebAPI 输出为什么必须使用 List？

一旦到了 WebAPI：

• 需要 JSON 序列化
• 需要确定类型结构
• 避免二次枚举风险
• 避免对 IEnumerable 懒加载造成性能问题

例如：

[HttpGet("templates")]
public List<TemplateDto> GetTemplates()
{
    var templates = _service.GetAllTemplates();
    return templates.ToList(); // Web 层统一转 List，安全可控
}

这也是为什么 ASP.NET Core 的 Ok() 默认使用 List<T> 更稳妥的原因。

📚 图示：API 层为什么要使用 List？

使用 List 的好处：

• JSON.NET / System.Text.Json 序列化更稳定
• 避免迭代器多次枚举导致性能问题
• 保证输出顺序与数据一致
• 前端收到的结构完全一致可预测

🔥 额外说明图：IEnumerable 和 List 的本质区别

• IEnumerable → 可枚举序列（关注过程）
• List → 具体集合结构（关注结果）

🎯 最终总结：一句话记住就够了

领域层和基础设施层返回的是“过程” → IEnumerable WebAPI 返回的是“结果” → List

保持边界清晰，架构自然会变得稳固。

✍️ 结语

架构不是写大而复杂的系统，而是坚持这些不起眼的小细节。 当每个层都使用自己的正确类型时，整个系统就开始变得：

• 更可维护
• 更清晰
• 更可替换
• 更符合 DDD 的设计哲学

关于 MUZINET · 技术博客

如果你正在寻找 青岛软件开发、烟台软件开发、企业官网建设或系统重构相关的技术解决方案，
欢迎关注 MUZINET 技术博客。我们长期专注于 .NET、DDD、Clean Architecture 以及企业级系统架构落地实践。