.NET Core Web API中实现多语言动态HTML邮件模板转换

核心思路 #

将静态文本与动态数据解耦，通过多语言资源文件管理不同语言的文案，结合字符串替换或模板引擎完成数据填充与内容组装，最终生成目标语言的邮件内容。

具体实现步骤 #

• 拆分模板内容：把邮件中的静态文案（如"Thank you for registering in our system"）提取为独立的语言键，保留{username}、{email}这类动态数据占位符。
• 构建多语言资源文件：为每种支持的语言创建配置文件，示例如下：
  • 英语配置（en.json）：

    {
      "register": {
        "greeting": "Hello {username}",
        "thank_you": "Thank you for registering in our system",
        "email_reminder": "Your registered email is {email}"
      }
    }
    

  • 韩语配置（ko.json）：

    {
      "register": {
        "greeting": "{username}님 안녕하세요",
        "thank_you": "시스템에 등록해 주셔서 감사합니다",
        "email_reminder": "등록하신 이메일은 {email}입니다"
      }
    }
    

• 加载语言资源并填充动态数据：根据用户选择的语言加载对应配置，使用字符串替换或模板引擎填充动态数据。示例JavaScript代码：

  // 加载目标语言配置
  const targetLocale = require(`./locales/${userSelectedLang}.json`);
  // 用户动态数据
  const userInfo = { username: '김철수', email: 'kim@example.com' };
  
  // 填充占位符
  const renderedGreeting = targetLocale.register.greeting.replace('{username}', userInfo.username);
  const renderedEmailReminder = targetLocale.register.email_reminder.replace('{email}', userInfo.email);
  const renderedThankYou = targetLocale.register.thank_you;
  

• 组装HTML邮件：将渲染后的多语言文本插入到HTML模板的对应位置，替换原模板中的静态文案与占位符。示例HTML模板片段：

  <div class="email-body">
    <h2>{{renderedGreeting}}</h2>
    <p>{{renderedThankYou}}</p>
    <p>{{renderedEmailReminder}}</p>
  </div>
  

• 发送邮件：将最终生成的目标语言HTML内容作为邮件正文，使用邮件发送库（如Nodemailer、JavaMail）完成发送。

关键注意事项 #

• 动态数据（如用户名、邮箱）若为用户输入内容，无需翻译，直接填充即可；若为系统生成内容，需确保其适配目标语言的格式（如日期、数字）。
• 选择支持国际化的模板引擎（如Handlebars、Thymeleaf）可大幅简化多语言内容的渲染流程。
• 邮件发送时需指定UTF-8编码，避免非英文字符出现乱码。

内容的提问来源于stack exchange，提问作者Jack Ray