DotNetEnv.Load() 未生效主因是未在当前工作目录放置.env文件或加载顺序错误；需显式指定路径、确保早于ConfigurationBuilder.AddEnvironmentVariables()调用，并用双引号包裹含空格等特殊字符的值。
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 了。