NLog.config文件怎么配置 NLog日志XML配置方法

NLog.config 是 NLog 框架的核心 XML 配置文件，需放在根目录并设为“始终复制”，包含 targets（输出目标）、rules（日志规则）及标准命名空间，支持控制台、文件等多目标输出与精准级别过滤。

NLog.config 文件是 NLog 日志框架的核心配置入口，用 XML 格式定义日志写到哪、按什么规则写、格式长什么样。只要文件位置正确、结构合法、目标和规则匹配，日志就能自动生效。

配置文件放哪才有效

NLog 启动时会按固定顺序查找配置，找到第一个就停止搜索，找不到直接失败：

• 独立程序（.exe）优先查：MyApp.exe.config → MyApp.exe.nlog → NLog.config（必须叫这个名字，大小写敏感）→ NLog.dll.nlog
• ASP.NET 程序优先查：web.config → web.nlog → NLog.config → NLog.dll.nlog
• 推荐统一用 NLog.config，放在项目根目录，并在 Visual Studio 中右键文件 → 属性 → “复制到输出目录”设为“如果较新则复制”或“始终复制”

基础XML结构三要素

一个最小可用的 NLog.config 必须包含 <targets></targets>、<rules></rules>，且根节点带标准命名空间：

• <targets></targets>：定义“写到哪”，比如文件、控制台、数据库。每个 <target></target> 要有唯一 name 和 xsi:type（如 File、Console）
• <rules></rules>：定义“谁写、写什么级别、写到哪个 target”，靠 name（支持通配符 *）、minlevel（如 Info）、writeTo 关联起来
• 根节点要声明命名空间：<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"></nlog>

示例（控制台+文件双输出）：

标签： app 栈 microsoft 配置文件 .net 2025