QT插件中不修改主程序代码添加INI配置项的问题

我在QT（C++）中开发软件插件，绝对不能修改主程序代码。主程序通过Config类管理INI配置，包含固定的枚举和映射：

主程序不可修改代码 #

ini.h（卡牌示例简化版） #

class CORE_LIBRARY_API Config : public QObject
{ 
  Q_OBJECT

  enum Key 
  {
    // General
    Version,
    // Cards
    King,
    Queen,
    Jack
  }
  // ... 其他代码
};

ini.cpp #

inline const QMap<Config::Key, QString> sKey 
{
  // General
  { Config::Version,            "Version"                   },
  // Cards
  { Config::King,               "Cards/King"                },
  { Config::Queen,              "Cards/Queen"               },
  { Config::Jack,               "Cards/Jack"                }
};
// ... 其他代码

主程序的QSettings相关逻辑：

bool Config::init()
{
   // ... 验证逻辑（无关）

   QSettings config(sConfigFilePath, QSettings::IniFormat);

   QMetaEnum metaEnum = QMetaEnum::fromType<Key>();

   // ... 验证逻辑（无关）
   return /* 验证结果 */;
}

QVariant Config::variant(const Key& card, const QVariant& cardfound)
{
  QSettings config(sConfigFilePath, QSettings::IniFormat);
  return config.value(sKey.value(card), cardfound);
}

插件自定义配置尝试 #

我在插件中新增Joker和Knight两个INI配置项，做法如下：

ftarot.h #

class FTarot : public Plugin
{ 
  Q_OBJECT
  enum Key 
  {
    // TarotCards
    Joker,
    Knight
  }
  // ... 其他代码
};

ftarot.cpp #

inline const QMap<FTarot::Key, QString> sKey 
{
  // TarotCards
  { FTarot::Joker,               "TarotCards/Joker"            },
  { FTarot::Knight,              "TarotCards/Knight"           }
};
// ... 其他代码

修改后的INI文件：

[General]
Version=x.x.x
[Cards]
King=3
Queen=3
Jack=1
[TarotCards]
Joker=8
Knight=2

现在插件无法读取Joker和Knight的值，请问我的做法有问题吗？还是需要排查QSettings初始化部分？

核心问题 #

你当前的做法存在本质问题：

• 插件的FTarot::Key枚举与主程序Config::Key是完全独立的类型，主程序的Config::variant()方法仅接受Config::Key类型参数，无法识别插件自定义的枚举值。
• 主程序的sKey映射中没有插件新增的配置项，即使强行传入（类型不兼容，编译都可能报错），也会因为找不到对应键而返回默认值。

解决方法 #

插件需要自行实现配置读取逻辑，不依赖主程序的Config类方法，直接使用QSettings读取自定义配置项：

1. 在插件中实现自定义读取方法 #

在ftarot.cpp中添加专属的配置读取函数：

QVariant FTarot::getTarotConfig(Key key, const QVariant& defaultValue)
{
    // 关键：确保使用与主程序相同的配置文件路径
    // 如果主程序未公开sConfigFilePath，可通过插件接口获取，或使用QSettings默认构造（需确保配置文件路径符合默认规则）
    QSettings config(sConfigFilePath, QSettings::IniFormat);
    return config.value(sKey.value(key), defaultValue);
}

2. 调用自定义方法读取配置 #

在插件业务逻辑中，通过上述方法读取值：

// 读取Joker配置
QVariant jokerValue = getTarotConfig(Joker, 0);
// 读取Knight配置
QVariant knightValue = getTarotConfig(Knight, 0);

排查要点 #

如果仍无法读取，需检查以下内容：

• 配置文件路径：确认插件中QSettings指向的文件与主程序使用的是同一个（路径完全一致）。
• 键名匹配：检查sKey中的映射路径（如TarotCards/Joker）与INI文件中的节、键名完全一致（Linux系统区分大小写）。
• 权限问题：确保插件对配置文件有读取权限。

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