Linux下C++如何配置文件

在 Linux 下用 C++ 进行程序配置，常见做法有几种，从简单到复杂，按使用场景选择即可。下面按推荐程度 + 实际项目经验给你一个完整说明。

一、常见配置文件方式（总览）

二、最简单：命令行参数（getopt）

适合少量参数。

示例

#include <unistd.h>
#include <iostream>

int main(int argc, char* argv[]) {
    int opt;
    std::string configFile;

    while ((opt = getopt(argc, argv, "c:")) != -1) {
        if (opt == 'c') {
            configFile = optarg;
        }
    }

    std::cout << "config file: " << configFile << std::endl;
}

运行：

./app -c config.json

✅ 优点：简单
❌ 缺点：不适合大量配置

三、INI 配置文件（推荐入门）

示例 config.ini

[server]
host = 127.0.0.1
port = 8080

[log]
level = info

读取方式

Linux 下没有标准 INI 库，可：

• 自己解析（简单）
• 使用第三方库（推荐）

第三方库（最常用）

• inih（轻量，单文件）
  • https://github.com/benhoyt/inih

示例（inih）

#include "ini.h"
#include <iostream>

int handler(void* user, const char* section,
            const char* name, const char* value) {
    std::cout << section << "." << name << " = " << value << "\n";
    return 1;
}

int main() {
    ini_parse("config.ini", handler, nullptr);
}

✅ 适合：小型服务、工具
❌ 不适合：复杂嵌套结构

四、JSON 配置（最推荐 ✅）

示例 config.json

{
    "server": {
        "host": "127.0.0.1",
        "port": 8080
    },
    "log": {
        "level": "debug"
    }
}

常用 JSON 库

使用 nlohmann/json（推荐）

安装

sudo apt install nlohmann-json3-dev

示例代码

#include <iostream>
#include <fstream>
#include "nlohmann/json.hpp"

using json = nlohmann::json;

int main() {
    std::ifstream in("config.json");
    json j;
    in >> j;

    std::string host = j["server"]["host"];
    int port = j["server"]["port"];

    std::cout << host << ":" << port << std::endl;
}

✅ 优点：

• 结构清晰
• 易扩展
• 工业级常用

五、YAML 配置（可读性最好）

示例 config.yaml

server:
  host: 127.0.0.1
  port: 8080
log:
  level: info

常用库

• yaml-cpp

安装

sudo apt install libyaml-cpp-dev

示例

#include <yaml-cpp/yaml.h>
#include <iostream>

int main() {
    YAML::Node config = YAML::LoadFile("config.yaml");

    std::string host = config["server"]["host"].as<std::string>();
    int port = config["server"]["port"].as<int>();

    std::cout << host << ":" << port << std::endl;
}

✅ 适合：大型项目、运维友好
❌ 依赖稍重

六、环境变量配置（系统级）

常用于 Docker / 云环境。

#include <cstdlib>
#include <iostream>

int main() {
    const char* port = std::getenv("APP_PORT");
    if (port) {
        std::cout << "port=" << port << std::endl;
    }
}

export APP_PORT=8080
./app

✅ 常配合 JSON / YAML 使用

七、推荐的项目配置结构 ✅

project/
├── bin/
│   └── app
├── conf/
│   ├── config.json
│   └── config.yaml
├── src/
└── CMakeLists.txt

读取时：

std::ifstream in("../conf/config.json");

八、如何选择？

✅ 新项目推荐顺序

1. JSON（nlohmann）
2. YAML（复杂配置）
3. INI（简单工具）
4. 命令行参数 + 环境变量

九、我可以进一步帮你

如果你愿意，可以告诉我：

• 是 服务端 / 客户端 / 嵌入式 / 驱动？
• 配置是否 热更新？
• 是否需要 线程安全？
• 是否用 CMake？

我可以直接给你一个 完整可编译的 C++ 配置模板。