INI 转 JSON
分节、注释、续行,一个都不少
如何使用本工具
- 左边贴 INI 配置,方向选自动识别就不用管是哪一种格式。
- 「值自动识别类型」会把 true / 30 / 1.5 转成布尔、整数和浮点,关掉则全当字符串。
- 缩进的行会拼到上一个值后面,用 \n 连接,适合写多行说明文字。
- 反向转 INI 时,嵌套对象会变成 [a.b] 这种分节,数组用逗号连接。
- 值里带等号、分号或井号时,生成的 INI 会自动加引号,避免被切碎。
常见问题
Q:INI 有官方标准吗?
A:没有。INI 只是一种约定,不同语言的实现细节差别很大:Python 的 configparser 默认不认冒号分隔,Windows 的 GetPrivateProfileString 认分号注释,MySQL 的 my.cnf 支持无值的裸键。本工具采用最宽松的解析:等号和冒号都当分隔符,分号和井号都当注释。
Q:为什么值里的井号不一定算注释?
A:因为 URL、密码里经常出现 # 和 ;。如果一律当注释,password = abc#123 会被切成 abc。本工具只把「空白字符 + 分号」之后的内容当行尾注释,井号只在一行开头才算,这样更安全。含特殊字符的值建议加引号。
Q:重复的键会怎样?
A:INI 没有规定重复键的行为,Python configparser 默认直接报错,Windows API 取第一个,很多实现取最后一个。本工具取最后一个并统计数量提示,方便你发现配置里是不是不小心写了两次。
Q:[a.b] 这种分节怎么理解?
A:带点的分节名会被当成层级路径,[a.b] 等价于 JSON 里 a 对象的 b 对象。很多工具(比如 .gitconfig、部分 PHP 框架)都用这种写法表达嵌套。反过来从 JSON 生成 INI 时也会输出成这种形式。
Q:数组在 INI 里怎么写?
A:没有标准答案。常见三种:逗号连接成一个值、重复写同名键、用 key.0 / key.1 分节。本工具生成时用逗号连接(标量数组),对象数组退化成 key.0 分节;解析时不会自动拆逗号,因为值本身可能就含逗号。
Q:和 TOML 有什么关系?
A:TOML 可以看成 INI 的严格升级版:有类型系统、有标准的数组和嵌套表语法、有明确的规范。如果配置项开始变复杂,建议直接换 TOML,别再扩展 INI 的非标准写法。