Shopify CLI本地切换店铺后预览报错：需在配置文件定义配色方案

问题场景 #

切换到另一Shopify店铺启动主题开发后，切回原店铺与主题文件夹，本地预览出现报错：To preview your changes, color schemes must be defined in settings_data and settings_schema files.，但线上店铺运行正常，本地config/settings_schema.json和config/settings_data.json均存在且未修改。

排查与解决步骤 #

• 重置CLI配置关联
  切换店铺后CLI可能缓存了错误的配置映射，执行以下命令强制拉取当前关联店铺的配置同步：

  shopify theme pull --config
  

  执行前建议备份本地config文件夹，避免自定义配置被覆盖。

• 验证颜色方案配置格式
  确认settings_schema.json中颜色方案的定义格式正确，示例如下：

  {
    "name": "Color schemes",
    "settings": [
      {
        "type": "color_scheme",
        "id": "color_scheme",
        "label": "Default color scheme",
        "default": {
          "color_background": "#ffffff",
          "color_text": "#000000"
        }
      }
    ]
  }
  

  同时检查settings_data.json中存在与上述id匹配的配置项，确保两者一一对应。

• 清除CLI本地缓存
  删除CLI的本地缓存目录，彻底重置上下文：

  • macOS/Linux：删除~/.shopify-cli文件夹
  • Windows：删除%USERPROFILE%\.shopify-cli文件夹
    之后重新登录目标店铺并启动开发：

  shopify auth login
  shopify theme dev
  

• 确认主题与店铺关联
  执行shopify theme info检查当前关联的店铺是否为原目标店铺，若关联错误，执行shopify theme switch重新选择原店铺的主题。

问题原因 #

切换店铺后，Shopify CLI的本地上下文未完全重置，导致配置文件的读取映射出现异常——虽然本地配置文件存在，但CLI未正确关联到当前店铺的配置规则，从而触发本地预览报错。

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