这是理解和编写 INI 格式配置文件的快速参考备忘单,此清单包含配置的内容,结构和语法等内容。
INI 是一种固定标准格式的配置文件,INI 配置方法来自 MS-DOS 操作系统
; 这里是注释
[owner]
name=John Doe
organization=Acme Products
[database]
; 这里是注释
server=192.0.2.42
port=143
file="acme payroll.dat"
现在已成为许多配置的非正式标准,其它操作系统可能使用 .conf
或 .cfg
作为后缀
名称
和值
构成,等号 (=) 分隔键名称
显示在等号的左侧
等号
和分号
是保留
字符name = value
与下面👇 JSON
大致相同
{
"name": "value"
}
注释 (;
)
; 这里是注释文本,将被忽略
注释 (#
)
# 这里是注释文本,⚠️ 部分编译器支持
一行之后的注释 (;
,#
) (不标准)
var = a ; 这是一个内联注释
foo = bar # 这是另一个内联注释
在某些情况下注释必须单独出现在行上
[
和 ]
中section 结束
分隔符section
声明处或文件末尾处结束[section]
key1 = a
key2 = b
与下面👇 JSON
大致相同
{
"section": {
"key1": "a",
"key2": "b"
}
}
[section]
domain = oxings.github.io
[section.subsection]
foo = bar
与下面👇 JSON
大致相同
{
"section": {
"domain": "oxings.github.io"
"subsection": {
"foo": "bar"
}
}
}
嵌套到上一节(简写)
[section]
domain = oxings.github.io
[.subsection]
foo = bar
序列 | 意思 |
---|---|
\\ |
\ (单个反斜杠,转义转义字符) |
\' |
撇号 |
\" |
双引号 |
\0 |
空字符 |
\a |
铃声/警报/声音 |
\b |
退格键,某些应用程序的贝尔字符 |
\t |
制表符 |
\r |
回车 |
\n |
换行 |
\; |
分号 |
\# |
数字符号 |
\= |
等号 |
\: |
冒号 |
\x???? |
十六进制代码点的 Unicode 字符对应于 ???? |
[section]
domain = oxings.github.io
array[]=first value
array[]=second value
与下面👇 JSON
大致相同
{
"section": {
"domain": "oxings.github.io",
"array": [
"first value", "second value"
]
}
}