Laravel 10与Vue.js 3多语言商品数据存储方案咨询

针对你提到的两种方案，结合Laravel生态的工具和最佳实践，给你梳理平衡性能、可维护性和易用性的具体方案：

一、核心方案对比与适配场景 #

1. JSON字段存储方案 #

• 优势：实现简单，无需额外数据表，适合语言数量少（如你的2种）、初期快速开发场景。Laravel原生支持数组与JSON字段的自动转换，存取逻辑直观。
• 劣势：复杂查询（如按某语言关键词筛选）的性能不如原生字段，无法直接为翻译内容创建普通索引（需借助生成列）。
• 适配场景：项目初期、语言数量固定（≤3种）、商品数据量不大的情况。

2. 独立翻译表方案 #

• 优势：结构清晰，支持灵活扩展多语言，翻译字段可单独创建索引，查询筛选效率更高，适合需要长期维护、可能新增语言的场景。
• 劣势：需要额外维护关联关系，查询时需注意预加载避免N+1问题，但Laravel的ORM可以轻松处理。
• 适配场景：预计会扩展更多语言、商品数据量大、需频繁对多语言内容做复杂查询的项目。

二、Laravel生态工具包推荐 #

1. spatie/laravel-translatable（JSON字段方案首选） #

这个包专门封装了多语言模型的JSON字段处理，完全适配Laravel 10，能大幅简化你的开发流程：

• 基本用法：
  在Product模型中引入Trait并声明可翻译字段：

  use Spatie\Translatable\HasTranslations;
  use Illuminate\Database\Eloquent\Model;
  
  class Product extends Model
  {
      use HasTranslations;
  
      // 声明需要多语言的字段
      public $translatable = ['name', 'description'];
  }
  

• 存取翻译：

  // 设置多种语言的内容
  $product->setTranslation('name', 'en', 'Cotton T-Shirt');
  $product->setTranslation('name', 'fr', 'T-shirt en coton');
  $product->save();
  
  // 获取当前语言的内容（自动匹配app()->getLocale()）
  echo $product->name;
  // 获取指定语言的内容
  echo $product->getTranslation('name', 'fr');
  

• 查询翻译内容：

  // 按英文名称筛选
  $products = Product::whereTranslation('name', 'Cotton T-Shirt', 'en')->get();
  // 模糊查询
  $products = Product::whereTranslationLike('name', '%T-Shirt%', 'en')->get();
  

• 表单处理：直接接收包含多语言的请求参数，Laravel的验证和填充都能自动适配：

  // 验证规则示例
  public function rules()
  {
      return [
          'name.en' => 'required|string|max:255',
          'name.fr' => 'required|string|max:255',
          'description.en' => 'required|string',
          'description.fr' => 'required|string',
      ];
  }
  
  // 保存数据
  $product = Product::create($request->validated());
  

2. astrotomic/laravel-translatable（独立翻译表方案首选） #

如果选择独立翻译表，这个包能帮你自动处理模型关联、翻译内容的存取和查询，避免重复编写关联逻辑：

• 核心特性：自动创建翻译模型和数据表，支持预加载翻译内容，提供丰富的查询方法，完全符合Laravel的ORM设计习惯。
• 基本用法：
  生成翻译模型和迁移：

  php artisan make:translatable Product
  

  这会自动创建ProductTranslation模型和对应的迁移文件，迁移文件中包含product_id、locale、name、description等字段。
• 存取与查询：

  // 设置翻译
  $product->translations()->create([
      'locale' => 'en',
      'name' => 'Cotton T-Shirt',
      'description' => 'Soft cotton fabric...',
  ]);
  
  // 获取当前语言的翻译
  $product->translate('name');
  // 获取指定语言的翻译
  $product->translate('name', 'fr');
  
  // 预加载翻译内容（避免N+1查询）
  $products = Product::with('translations')->get();
  // 按指定语言的名称筛选
  $products = Product::whereTranslation('name', 'Cotton T-Shirt', 'en')->get();
  

三、最佳实践建议 #

1. 初期优先选JSON方案：如果你目前只需要支持2种语言，用spatie/laravel-translatable能快速完成开发，后续如果需要扩展，也可以考虑迁移到独立翻译表（有工具支持迁移）。
2. 优化JSON字段查询性能：如果用JSON字段且需要频繁查询某语言的内容，可以在数据库中创建生成列并添加索引：

   -- 为英文名称创建生成列和索引
   ALTER TABLE products ADD COLUMN name_en VARCHAR(255) AS (JSON_UNQUOTE(translations->"$.en.name")) STORED;
   CREATE INDEX idx_products_name_en ON products(name_en);
   

   之后查询时可以直接使用name_en字段，性能和原生字段一致。
3. 前后端配合：前端已经配置了Vue i18n，后端可以直接返回当前语言的商品字段（通过Laravel的资源类自动处理），或者返回所有翻译内容让前端根据当前语言切换，根据你的业务需求选择即可。
4. 避免N+1查询：如果用独立翻译表，务必使用with('translations')预加载关联内容，或者在模型中设置默认预加载，提升查询性能。

内容的提问来源于stack exchange，提问作者Kenza ES