不支持。Microsoft.FeatureManagement 仅面向 .NET Core 3.1+ 和 .NET 5+，依赖现代 DI 模式，.NET Framework 4.7.2 及更早版本无法使用，强行降级旧版也无效。
FeatureManagement 库是否支持 .NET Framework？
不支持。Microsoft.FeatureManagement 仅面向 .NET Core 3.1+ 和 .NET 5+，底层依赖 IConfiguration 和 IServiceCollection 的现代 DI 模式。如果你还在用 .NET Framework 4.7.2 或更早版本，直接 NuGet 安装会失败，且无法通过手动引用绕过依赖链。
替代方案只有两个：自己实现轻量级开关（比如读 JSON 配置 + 静态字典缓存），或升级运行时。强行降级到旧版 Microsoft.FeatureManagement（如 2.x）也无效——它从 1.0 开始就放弃对 Framework 的适配。
如何注册 Feature Flag 并启用 IFeatureManager？
在 Program.cs（.NET 6+）或 Startup.ConfigureServices 中调用 AddFeatureManagement()，这是启用整个功能的基础步骤。它会自动注入 IFeatureManager 和 IFeatureManagerSnapshot。
常见遗漏点：
- 忘了调用
AddFeatureManagement()，导致 DI 容器里没有IFeatureManager - 配置源没加载成功，比如
appsettings.json里漏了"FeatureManagement"节点 - 用了自定义配置节名但没传参，例如
AddFeatureManagement(Configuration.GetSection("MyFlags"))
最小可行注册示例：
builder.Services.AddFeatureManagement();
对应配置结构必须存在：
"FeatureManagement": {
"BetaFeature": true,
"NewCheckout": false
}
如何在控制器或服务中判断某个 Feature 是否启用？
用 IFeatureManager.IsEnabledAsync(string featureName) 是最常用方式，它支持异步、可插拔的评估器（比如基于用户角色、时间窗、百分比流量等）。同步版本 IsEnabled(string) 仅适用于极简场景，且不推荐在 Web 请求中使用（可能阻塞线程）。
注意几个关键行为：
- featureName 区分大小写，
"betafeature"和"BetaFeature"是两个不同开关 - 如果配置里没定义该 flag，默认返回
false（不是异常） - 若启用了缓存（默认开启），首次查询后结果会暂存 30 秒，期间修改配置不会立即生效
- 想跳过缓存强制重查，用
IFeatureManagerSnapshot替代IFeatureManager
典型用法：
public class HomeController : Controller
{
private readonly IFeatureManager _featureManager;
public HomeController(IFeatureManager featureManager) => _featureManager = featureManager;
public async Task<IActionResult> Index()
{
var isNewCheckoutOn = await _featureManager.IsEnabledAsync("NewCheckout");
return isNewCheckoutOn ? View("NewCheckout") : View("LegacyCheckout");
}
}
为什么 Feature Flag 在本地调试时始终为 false？
大概率是配置未被正确加载进 IConfiguration。FeatureManagement 库完全依赖 IConfiguration 提供的数据源，它不会自动扫描 appsettings.Development.json —— 这个行为由宿主（Host）控制，不是库的责任。
检查以下三点：
- 确认
builder.Configuration确实加载了当前环境对应的配置文件（例如AddJsonFile("appsettings.Development.json", optional: true)） - 确认
"FeatureManagement"节点位于正确的配置文件中，而不是写在"Logging"或根节点下 - 启动时加一行日志：
Console.WriteLine(builder.Configuration.GetSection("FeatureManagement").GetChildren().Count());，输出为 0 就说明没加载到
另一个隐蔽原因：你用了 AddFeatureManagement(Configuration.GetSection("Features"))，但配置里实际是 "FeatureManagement"，名字不匹配也会静默失败。
复杂点在于，FeatureManagement 的扩展性很强，但代价是每多一层自定义（比如自定义 IFeatureFilter、带参数的评估逻辑、外部配置中心集成），出问题的位置就更分散——配置加载、DI 注册、过滤器实现、缓存策略，任何一环断掉都表现为“flag 总是 false”。建议先跑通纯内存配置，再逐步叠加能力。
