Ошибка Boost::program_options «опция не может быть указана более одного раза» при реализации программы с несколькими режимами

В основе проблемы лежит то, что positional_options_descriptions::add не принимает «индекс позиции». Требуется max_count!

В вашем случае всегда должно быть 1. Если вы действительно хотите взять несколько, базовая опция должна поддерживать это:

("mode_2_option_2", po::value<std::vector<std::string>>()->required())

Сравнивать

Прямой эфир на Колиру

#include <boost/program_options.hpp>
#include <iomanip>
#include <iostream>
namespace po = boost::program_options;

int main(int argc, char* argv[]) {
    bool modeB = false;

    po::options_description general_options_desc("General Options");
    general_options_desc.add_options()
        ("help,h", "this help message");

    po::options_description mode_options_desc("Mode options");
    mode_options_desc.add_options()
        ("modeB,B", po::bool_switch(&modeB), "specify mode 2 operations");

    po::options_description required("Required Options");
    required.add_options()
        ("req_last1", po::value<std::string>()->required());

    { /* Set modeB */
        po::variables_map mode_vm;
        store(po::command_line_parser(argc, argv) //
                  .options(mode_options_desc)
                  .allow_unregistered()
                  .run(),
              mode_vm);
        notify(mode_vm);
    }

    po::options_description visible_options_desc("Visible Options");
    visible_options_desc.add(general_options_desc);
    visible_options_desc.add(mode_options_desc);

    po::options_description optsA("Mode #1 Options");
    optsA.add_options()
        ("A1", po::value<std::string>()->required());

    po::options_description optsB("Mode #2 Options");
    optsB.add_options()
        ("B1", po::value<std::string>()->required())
        ("B2", po::value<std::vector<std::string>>()->required())
        ("B3", po::value<std::string>()->required());

    po::options_description all_options_desc("All Options");
    all_options_desc.add(visible_options_desc);

    po::positional_options_description positionals;

    if (!modeB) {
        positionals.add("A1", 1);
        all_options_desc.add(optsA);
    } else {
        positionals.add("B1", 1);
        positionals.add("B2", 1);
        positionals.add("B3", 1);
        all_options_desc.add(optsB);
    }

    positionals.add("req_last1", 1);
    {
        std::cout << "positional(" << positionals.max_total_count() << "):";
        for (size_t i = 0; i < positionals.max_total_count(); i++)
            std::cout << " " << positionals.name_for_position(i);
        std::cout << "\n";
    }
    all_options_desc.add(required);

    po::variables_map vm;
    store(po::command_line_parser(argc, argv) //
              .options(all_options_desc)
              .positional(positionals)
              .run(),
          vm);

    if (vm.count("help")) {
        fprintf(stderr, "Usage:\n");
        fprintf(stderr, "   test_program [General Options] <A1> <req_last1>\n");
        fprintf(stderr, "   test_program [General Options] --modeB <B1> <B2> <B3> <req_last1>\n\n");
        if (modeB) {
            optsB.print(std::cout);
        } else {
            optsA.print(std::cout);
        }
        visible_options_desc.print(std::cout);
        return 0;
    }

    for (auto [k, v] : vm) {
        if (v.value().type() == typeid(std::string)) {
            std::cout << k << ": " << quoted(v.as<std::string>()) << "\n";
        } else if (v.value().type() == typeid(bool)) {
            std::cout << k << ": " << std::boolalpha << v.as<bool>() << "\n";
        } else if (v.value().type() == typeid(std::vector<std::string>)) {
            std::cout << k << ":";
            for (auto& s : v.as<std::vector<std::string>>())
                std::cout << " " << quoted(s);
            std::cout << "\n";
        } else {
            std::cout << k << ": " << "???\n";
        }
    }
}

Печать, например.

Теперь сделай это

 positionals.add("B2", 3); // expect B2 three time

Теперь мы видим Прямой эфир на Колиру

$ ./a.out foo this is really too much -B
positional(6): B1 B2 B2 B2 B3 req_last1
B1: "foo"
B2: "this" "is" "really"
B3: "too"
modeB: true
req_last1: "much"