# .NET CLI 命令（推薦）
dotnet add package NLog
# 或 NuGet 包管理器控制臺
Install-Package NLog

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true"  <!-- 配置修改后自動生效，無需重啟 -->
      throwConfigExceptions="true"> <!-- 開發(fā)時開啟，配置錯誤拋異常 -->

  <!-- 變量定義：簡化重復(fù)配置 -->
  <variable name="logDir" value="${basedir}/logs"/>
  <variable name="logLayout" value="${longdate} | ${level:uppercase=true} | ${logger} | ${message} ${exception:format=ToString}"/>

  <!-- 輸出目標：控制臺 + 按天分割的文件 -->
  <targets>
    <!-- 控制臺輸出（開發(fā)調(diào)試） -->
    <target name="console" xsi:type="Console" layout="${logLayout}"/>
    <!-- 文件輸出（生產(chǎn)環(huán)境核心） -->
    <target name="file" xsi:type="File" 
            fileName="${logDir}/${shortdate}.log"  <!-- 日志路徑：項目目錄/logs/2025-12-25.log -->
            archiveEvery="Day"  <!-- 按天歸檔 -->
            maxArchiveFiles="30"  <!-- 保留30天日志 -->
            encoding="UTF-8"
            layout="${logLayout}"/>
  </targets>

  <!-- 日志規(guī)則：所有Info及以上級別輸出到控制臺+文件 -->
  <rules>
    <logger name="*" minlevel="Info" writeTo="console,file" />
  </rules>
</nlog>

using NLog;

namespace NLogDemo
{
    class Program
    {
        // 核心：創(chuàng)建Logger（推薦每個類一個，用當(dāng)前類名命名，便于定位日志來源）
        private static readonly ILogger _logger = LogManager.GetCurrentClassLogger();

        static void Main(string[] args)
        {
            try
            {
                // 1. 輸出不同級別的日志（按需選擇）
                _logger.Info("程序啟動成功，開始執(zhí)行業(yè)務(wù)邏輯");
                _logger.Warn("注意：當(dāng)前內(nèi)存使用率超過80%");

                // 模擬業(yè)務(wù)操作
                var userId = 1001;
                _logger.Info($"用戶 {userId} 發(fā)起查詢請求");

                // 2. 模擬異常，記錄帶堆棧的錯誤日志（核心場景）
                throw new InvalidOperationException("數(shù)據(jù)庫查詢超時");
            }
            catch (Exception ex)
            {
                // 第一個參數(shù)：異常對象（自動記錄堆棧）；第二個參數(shù)：自定義日志消息
                _logger.Error(ex, "執(zhí)行業(yè)務(wù)邏輯時發(fā)生錯誤");
            }
            finally
            {
                // 釋放NLog資源（控制臺應(yīng)用結(jié)束時建議調(diào)用）
                LogManager.Shutdown();
            }
        }
    }
}

dotnet add package NLog.Web.AspNetCore

using NLog;
using NLog.Web;

var builder = WebApplication.CreateBuilder(args);

// 1. 清除.NET默認日志提供器，啟用NLog
builder.Logging.ClearProviders();
builder.Host.UseNLog(); // 注冊NLog到ASP.NET Core依賴注入

// 2. 添加MVC等服務(wù)（常規(guī)操作）
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 3. 中間件配置（常規(guī)操作）
app.UseRouting();
app.UseEndpoints(endpoints => endpoints.MapControllers());

app.Run();

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;

namespace NLogWebDemo.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class UserController : ControllerBase
    {
        // 注入ILogger（泛型參數(shù)為當(dāng)前類，便于日志定位）
        private readonly ILogger<UserController> _logger;

        public UserController(ILogger<UserController> logger)
        {
            _logger = logger;
        }

        [HttpGet("{id}")]
        public IActionResult Get(int id)
        {
            // 記錄普通日志
            _logger.LogInformation("接收到用戶查詢請求，ID：{UserId}", id);

            try
            {
                // 模擬業(yè)務(wù)邏輯
                if (id <= 0)
                {
                    throw new ArgumentException("用戶ID不能為負數(shù)");
                }
                return Ok(new { Id = id, Name = "張三" });
            }
            catch (Exception ex)
            {
                // 記錄錯誤日志
                _logger.LogError(ex, "查詢用戶信息失敗，ID：{UserId}", id);
                return BadRequest("查詢失敗");
            }
        }
    }
}