VTEX开发工作区创建的产品意外出现在主工作区，如何解决？

核心原因 #

VTEX默认机制下，开发工作区会与主工作区共享**目录类数据（如产品、库存）**的双向同步，若未配置隔离规则，新增产品会自动同步到主工作区。

具体解决步骤 #

• 配置工作区数据隔离

  1. 进入VTEX管理面板，切换至目标开发工作区
  2. 打开「工作区设置」（Workspace Settings）
  3. 在「数据同步」（Data Sync）板块找到「目录数据」（Catalog Data）选项
  4. 将同步模式从「继承并同步主工作区」修改为「完全隔离」（Isolated）

• 确认创建产品的工作区上下文
  创建产品前，确保页面顶部的工作区标识为目标开发工作区；若通过API创建，需在请求头中指定X-VTEX-Workspace为你的开发工作区名称。

• 清理已同步到主工作区的产品
  若已有产品意外同步到主工作区：

  1. 切换至主工作区，找到对应产品
  2. 根据需求选择「删除」或「下架」操作
  3. 返回开发工作区，重新确认产品的隔离状态

额外注意事项 #

• 开启隔离后，开发工作区的目录数据将不再与主工作区双向同步，新增、修改的产品仅保留在当前开发工作区
• 后续若需将开发区产品同步到主工作区，需手动执行「工作区合并」（Workspace Merge）操作，合并前会有预览确认环节

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