DotNetEnv.Load() 为什么没生效？检查当前工作目录
DotNetEnv 不会自动搜索项目根目录下的
.env，它只在调用时的 当前工作目录（
Environment.CurrentDirectory）下找文件。控制台程序默认是输出目录（如
bin/Debug/net8.0），而 ASP.NET Core 默认是发布目录或运行目录——但都不一定是你放
.env的地方。
常见错误现象：
DotNetEnv.Load()执行后
Environment.GetEnvironmentVariable("DB_HOST") 仍返回 null。 先确认
.env文件确实放在
Environment.CurrentDirectory下，可用
Console.WriteLine(Environment.CurrentDirectory)打印路径 推荐显式指定路径：
DotNetEnv.Load(".env") 或 DotNetEnv.Load(Path.Combine(AppContext.BaseDirectory, ".env"))ASP.NET Core 中建议在
Program.cs最开头加载，早于任何依赖注入配置
环境变量被覆盖？注意加载顺序和作用域
DotNetEnv 把键值对写入进程级环境变量，但 .NET 的
Environment.GetEnvironmentVariable()读取的是当前进程的快照，且 Windows/Linux 对大小写处理不同——
DOT_ENV和
dot_env在 Windows 是同一个变量，在 Linux 是两个。
使用场景：你同时用了
dotnet user-secrets、
appsettings.json和
.env，结果发现某些值没被替换。
DotNetEnv.Load()必须在其他配置源（如
ConfigurationBuilder.AddEnvironmentVariables()）之前调用，否则会被后续加载的变量覆盖 避免重复调用
Load()，多次加载相同 key 会导致最后那次生效，容易误判“没加载” 敏感值（如密码）不建议直接进环境变量，尤其在容器或共享主机中；
.env文件本身也应加到
.gitignore
值里有空格或特殊字符？必须用引号包裹
DotNetEnv 解析规则接近 POSIX shell，但不完全兼容 Bash。它对空格、
#、
=、换行等很敏感——不加引号的值一旦含空格，就只取第一个单词。
错误示例：
API_URL=https://api.example.com/v1/users?sort=name asc→ 实际加载为
API_URL="https://api.example.com/v1/users?sort=name"，
asc丢失。 所有含空格、
#、
$、
\的值，统一用双引号包裹：
API_URL="https://api.example.com/v1/users?sort=name asc"单引号无效，DotNetEnv 不支持单引号语法 注释只能独占一行，且必须以
#开头；
KEY=value # comment这种内联注释会被整个当作 value
ASP.NET Core 集成时 ConfigurationBuilder 没读到？别漏掉 AddEnvironmentVariables()
DotNetEnv 只负责把
.env写进进程环境变量，但 ASP.NET Core 的
IConfiguration默认不会自动从进程环境变量建模——除非你显式加了
AddEnvironmentVariables()。
典型症状：调试时
Environment.GetEnvironmentVariable("DB_NAME") 能取到，但 configuration["DB_NAME"]为
null。 确保在
Program.cs中构建配置时包含这行：
.AddEnvironmentVariables()加载顺序关键：先
DotNetEnv.Load()，再
new ConfigurationBuilder().AddEnvironmentVariables()如果用了
WebHost.CreateDefaultBuilder()，它内部已含
AddEnvironmentVariables()，但前提是 DotNetEnv 已提前写入环境变量
真正容易被忽略的是：DotNetEnv 不解析变量引用（比如
BASE_URL=https://example.com+
API_URL=$BASE_URL/api），它不支持这种语法。需要自己实现替换，或者换用支持该特性的库——但那就不是 DotNetEnv 了。
