一个简单又好用的.Net版本.env文件读写操作库

推荐一个开源库,方便我们从 .env 文件加载环境变量,简化应用程序配置管理。

01 项目简介

dotenv.net是一个职场 .NET Core 环境中读取 .env 文件的库。它可以轻松地加载环境变量到应用程序的配置中,从而实现不同环境下的配置管理。

  • 简单且无痛🎯:.env只需最少的设置即可轻松加载和读取文件。

  • 灵活的配置🔧:使用各种选项自定义环境变量的加载方式。

  • 依赖注入支持🧩:与流行的 DI 框架无缝协作。

  • 跨平台🌍:与.NET Core、.NET 5 及更高版本完全兼容。

02 快速入门

1、安装

使用 .NET CLI

csharp 复制代码
dotnet add package dotenv.net

使用 Visual Studio 包管理器

复制代码
Install-Package dotenv.net

2、简单使用方法

ini 复制代码
using dotenv.net;
DotEnv.Load();
var envVars = DotEnv.Read();
Console.WriteLine(envVars["KEY"]);

其中Load()的时候,会从而应用程序的目录读取.env文件。

3、自定义.env文件路径

php 复制代码
DotEnv.Load(options: new DotEnvOptions(envFilePaths: new[] {"./path/to/env", "./path/to/second/env"}));

4、启用异常处理

php 复制代码
DotEnv.Load(options: new DotEnvOptions(ignoreExceptions: false));

5、在父目录中搜索.env文件

php 复制代码
DotEnv.Load(options: new DotEnvOptions(probeForEnv: true, probeLevelsToSearch: 2));

6、去掉值的空白字符

php 复制代码
DotEnv.Load(options: new DotEnvOptions(trimValues: true));

7、多次加载,是否不覆盖现有环境变量

php 复制代码
DotEnv.Load(options: new DotEnvOptions(overwriteExistingVars: false));

8、提供一个流畅的 API,更简洁直观的语法

scss 复制代码
// 加载环境变量
DotEnv.Fluent()
    .WithExceptions()
    .WithEnvFiles("./path/to/env")
    .WithTrimValues()
    .WithEncoding(Encoding.ASCII)
    .WithOverwriteExistingVars()
    .WithProbeForEnv(probeLevelsToSearch: 6)
    .Load();

// 读取环境变量
var envVars = DotEnv.Fluent()
    .WithoutExceptions()
    .WithEnvFiles() //默认为 .env
    .WithoutTrimValues()
    .WithDefaultEncoding()
    .WithoutOverwriteExistingVars()
    .WithoutProbeForEnv()
    .Read();

9、另外提供 Utilities 命名空间,以类型化方式读取环境变量的额外方法:

ini 复制代码
using dotenv.net.Utilities;

var stringValue = EnvReader.GetStringValue("KEY");
var intValue = EnvReader.GetIntValue("PORT");
var boolValue = EnvReader.GetBooleanValue("ENABLE_FEATURE");

更多的方法如下:

03 项目地址

github.com/bolorunduro...

  • End -

推荐阅读

2个零基础入门框架教程!

SmartFormat:轻量级文本模板库,轻松替代 string.Format

Squidex:一个基于.Net功能强大的CMS开源项目

barcodelib:一个功能强大且易于使用的 C# 条形码生成库

一文掌握DeepSeek本地部署+Page Assist浏览器插件+C#接口调用+局域网访问!全攻略来了!

相关推荐
他们叫我秃子33 分钟前
前端开发转 Go 全栈(五):终于遇到熟人了,Go 的闭包和高阶函数原来这么像 JavaScript
前端·后端·go
SomeB1oody35 分钟前
【RustyML入门】2.6. 线性判别分析
开发语言·后端·机器学习·rust·教程
妙码生花36 分钟前
从 PHP 到 AI + Golang,程序员自救转型手记(五十七):AI时代对组件封装的新理解、agInput 统一入口,动态表单预备
前端·后端·go
Yao80637 分钟前
SpringAI + Ollama + DeepSeek + RAG 搭建 AI 航线规划系统
后端
大勇前进38 分钟前
SQL Server 分页查询多种写法对比:哪种性能最高?
后端
妙码生花41 分钟前
从 PHP 到 AI + Golang,程序员自救转型手记(五十六):附件管理、增加根据文件后缀生成 SVG 文件图标的接口
前端·后端·go
前端Hardy1 小时前
Vue 终于杀进终端界!这个开源项目让 CLI 开发像写网页一样简单
前端·javascript·后端
老孙讲技术1 小时前
周界枪响了、电梯脸却进了物业群:一个 callback,怎么把 alarm 和 faceAnalysis 拆成两条值班线?
后端·物联网
大勇前进1 小时前
千万级大表 SQL Server 查询慢?一套可落地的性能调优实战路径
后端
前端开发张小七1 小时前
Java 学习笔记 · 第三课:多线程与并发编程(线程、同步、死锁、Lock、乐观锁与悲观锁)
java·后端·程序员