i18n-tasks 配置文件中使用 ERB 的注意事项

在使用 i18n-tasks 国际化工具时，很多开发者希望在配置文件中使用 ERB 模板来动态加载配置值，特别是 Rails 应用中的敏感信息。然而，这里有一些重要的技术细节需要注意。

配置加载机制

i18n-tasks 的设计理念是保持轻量级，因此它的配置加载过程不会自动加载整个 Rails 环境。当你在配置文件中使用类似 <%= Rails.application.credentials.dig(:openai, :access_token) %> 的代码时，会抛出 uninitialized constant Rails 错误，因为 Rails 常量尚未定义。

解决方案

方案一：手动加载 Rails 环境

虽然不推荐，但你可以在配置文件中显式加载 Rails 环境：

<%
require 'rails'
Rails.application.require_environment!
%>
base_locale: en
search:
  translation:
    openai_api_key: <%= Rails.application.credentials.dig(:openai, :access_token) %>

这种方法会使 i18n-tasks 启动变慢，因为它需要加载整个 Rails 应用。

方案二：使用环境变量

更推荐的做法是使用环境变量：

base_locale: en
search:
  translation:
    openai_api_key: <%= ENV['OPENAI_API_KEY'] %>

然后在启动命令前设置环境变量：

OPENAI_API_KEY=your_key_here bundle exec i18n-tasks health

方案三：单独加载所需部分

如果只需要访问 Rails 的 credentials，可以只加载必要的部分：

<%
require 'rails/application'
require 'rails/configuration'
%>
base_locale: en
search:
  translation:
    openai_api_key: <%= Rails.application.credentials.dig(:openai, :access_token) %>

最佳实践

1. 避免在配置中加载整个应用：保持 i18n-tasks 的轻量级特性
2. 使用最小化依赖：只加载真正需要的部分
3. 考虑安全性：敏感信息最好通过环境变量传递
4. 性能考量：频繁执行的命令应尽量减少初始化开销

总结

i18n-tasks 的设计哲学强调快速启动和轻量级，因此在配置中使用 ERB 时需要特别注意依赖关系。理解这一机制后，开发者可以选择最适合项目需求的配置方式，在功能性和性能之间取得平衡。