281 lines
432 KiB
HTML
281 lines
432 KiB
HTML
|
<!DOCTYPE html>
|
|||
|
<html><head><title>结构化文件</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="结构化文件"/><meta property="og:description" content="文章提供了对多种结构化配置文件格式的全面介绍,包括它们的基本概念、语法结构、优缺点及适用场景。."/><meta property="og:image" content="https://wiki.7wate.com/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="../../../static/icon.png"/><meta name="description" content="文章提供了对多种结构化配置文件格式的全面介绍,包括它们的基本概念、语法结构、优缺点及适用场景。."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><script async src="https://umami.7wate.com/script.js" data-website-id="c061efdc-95dd-4d21-9d04-a1ffda0a85b9"></script><script>
|
|||
|
var _hmt = _hmt || [];
|
|||
|
(function() {
|
|||
|
var hm = document.createElement("script");
|
|||
|
hm.src = "https://hm.baidu.com/hm.js?94d8ccb156eb7c65abf317e6e01cdba9";
|
|||
|
var s = document.getElementsByTagName("script")[0];
|
|||
|
s.parentNode.insertBefore(hm, s);
|
|||
|
})();
|
|||
|
</script><script async src="https://www.googletagmanager.com/gtag/js?id=G-MHMEL0F832"></script><script>
|
|||
|
(function() {
|
|||
|
window.dataLayer = window.dataLayer || [];
|
|||
|
function gtag() {
|
|||
|
window.dataLayer.push(arguments);
|
|||
|
}
|
|||
|
gtag('js', new Date());
|
|||
|
gtag('config', 'G-MHMEL0F832');
|
|||
|
})();
|
|||
|
</script><link href="../../../index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&family=Schibsted Grotesk:wght@400;700&family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="../../../prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`../../../static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="Tech/getting-started/文本处理/结构化文件"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title "><a href="../../..">📚 X·Eden</a></h1><div class="spacer mobile-only"></div><div class="search "><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode "><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.447,9.447-14.65,22.008-14.65,35.369 c0,13.
|
|||
|
<p>在现代软件开发和系统管理中,结构化配置文件是不可或缺的工具。它们允许开发者和系统管理员以一种标准化和易于理解的方式组织配置数据,这些数据控制着应用程序的行为和环境的特性。无论是简单的本地应用还是复杂的分布式系统,合适的配置文件格式都可以大幅提高项目的可维护性、可扩展性和透明度。</p>
|
|||
|
<p>结构化配置文件的主要作用包括但不限于:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>提高自动化水平</strong>:自动部署和管理工具广泛依赖结构化数据来执行复杂的操作。</li>
|
|||
|
<li><strong>促进团队协作</strong>:统一的配置格式使得不同背景的开发者能够轻松理解和修改设置。</li>
|
|||
|
<li><strong>增加应用的灵活性</strong>:通过外部配置文件,应用程序可以不需修改代码即可适应不同环境。</li>
|
|||
|
<li><strong>支持环境隔离</strong>:不同环境(如开发、测试和生产)可以使用不同的配置,而不会互相干扰。</li>
|
|||
|
</ul>
|
|||
|
<p>选择对比 INI、YAML、XML、JSON、TOML、HCL 和 CSON 这些特定格式的原因基于它们在业界的广泛应用和独特优势。每种格式都有其特定的用途和优点,例如:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>INI</strong> 和 <strong>TOML</strong> 通常用于简单直观的配置需求。</li>
|
|||
|
<li><strong>YAML</strong> 和 <strong>HCL</strong> 适合处理复杂的层次结构,广泛应用于现代 DevOps 工具。</li>
|
|||
|
<li><strong>XML</strong> 因其扩展性和强大的自描述能力,常用于企业级应用。</li>
|
|||
|
<li><strong>JSON</strong> 的轻量性和易于交互的特性使其成为 Web 应用的首选。</li>
|
|||
|
<li><strong>CSON</strong> 提供了对 CoffeeScript 用户更友好的语法。</li>
|
|||
|
</ul>
|
|||
|
<h2 id="ini">INI<a aria-hidden="true" tabindex="-1" href="#ini" class="internal"> §</a></h2>
|
|||
|
<p>INI 文件格式(Initialization File)起源于 Windows 操作系统,用于存储程序的设置。它由节、键和值组成,结构简单直观。INI 文件因其易于编辑和理解,以及良好的人类可读性,被广泛用于应用程序的配置。虽然在功能上比较基础,但 INI 文件依然在许多现代应用程序中发挥作用,特别是在需要简单配置而不涉及复杂层次结构的场合。</p>
|
|||
|
<h3 id="基础语法和结构">基础语法和结构<a aria-hidden="true" tabindex="-1" href="#基础语法和结构" class="internal"> §</a></h3>
|
|||
|
<p>INI 文件的结构基于“节”(sections)和“键值对”(key-value pairs)。文本以方括号括起的标题开始,表示一个节,节下方跟随键值对,键与值之间用等号(=)连接。例如:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="ini" data-theme="default"><code data-language="ini" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">[database]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">server</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> 192.168.1.1</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">port</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> 3306</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">username</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> admin</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">password</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> admin123</span></span></code></pre></div>
|
|||
|
<p>在这个例子中,<code>database</code> 是一个节,而 <code>server</code>、<code>port</code>、<code>username</code> 和 <code>password</code> 是键,右侧的内容则是对应的值。注释可以通过在行首添加分号(;)或井号(#)来实现。</p>
|
|||
|
<h3 id="应用案例">应用案例<a aria-hidden="true" tabindex="-1" href="#应用案例" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>应用配置</strong>:INI 文件经常用于存储应用程序的配置设置。例如,一个视频游戏可能使用 INI 文件来保存用户的视频设置和偏好控制配置。</li>
|
|||
|
<li><strong>服务配置</strong>:在许多传统服务器软件中,INI 文件被用来配置服务器的基本属性,如数据库连接详情和网络设置。</li>
|
|||
|
<li><strong>开发环境设置</strong>:一些开发工具和环境(如 PHP 的 <code>php.ini</code>)使用 INI 文件来调整环境设置,影响语言的功能和性能。</li>
|
|||
|
</ul>
|
|||
|
<p>INI 文件的简洁性使其在不需要复杂数据结构的场景中非常适用,尤其是在快速开发和原型制作阶段。尽管现代开发趋向于使用更灵活的格式如 JSON 或 YAML,INI 文件仍保留了其实用性和便捷性。</p>
|
|||
|
<h2 id="yaml">YAML<a aria-hidden="true" tabindex="-1" href="#yaml" class="internal"> §</a></h2>
|
|||
|
<p>YAML(YAML Ain’t Markup Language)是一种以数据作为中心的序列化格式,设计理念是易于阅读和书写,同时具有一定的可扩展性。YAML 特别适用于配置文件、数据交换和复杂数据结构的存储,常被用于现代开发环境和应用,如容器编排和 DevOps 场景。</p>
|
|||
|
<h3 id="基础语法和结构-1">基础语法和结构<a aria-hidden="true" tabindex="-1" href="#基础语法和结构-1" class="internal"> §</a></h3>
|
|||
|
<p>YAML 的数据结构由映射(键值对)、序列(列表)和标量(单个的、不可再分的值)组成。重要的特点包括:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>缩进</strong>:用于表示层级关系,缩进方式代表数据结构的嵌套。</li>
|
|||
|
<li><strong>列表</strong>:使用破折号(<code>-</code>)开始新的列表项。</li>
|
|||
|
<li><strong>字典</strong>:键后面跟一个冒号和一个空格,用以分隔键和值。</li>
|
|||
|
</ul>
|
|||
|
<p>示例:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="yaml" data-theme="default"><code data-language="yaml" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">users</span><span style="color:var(--shiki-token-keyword);">:</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> - </span><span style="color:var(--shiki-token-keyword);">name</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">John Doe</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">age</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">30</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> - </span><span style="color:var(--shiki-token-keyword);">name</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">Jane Smith</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">age</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">25</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">settings</span><span style="color:var(--shiki-token-keyword);">:</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">color</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">blue</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">enabled</span><span style="color:var(--shiki-token-keyword);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">true</span></span></code></pre></div>
|
|||
|
<h3 id="应用案例-1">应用案例<a aria-hidden="true" tabindex="-1" href="#应用案例-1" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>Kubernetes</strong>:YAML 用于定义容器和服务的配置,如 Pods、Deployments 等。</li>
|
|||
|
<li><strong>CI/CD 管道</strong>:如 GitLab CI 和 GitHub Actions 中定义作业和工作流。</li>
|
|||
|
</ul>
|
|||
|
<h2 id="xml">XML<a aria-hidden="true" tabindex="-1" href="#xml" class="internal"> §</a></h2>
|
|||
|
<p>XML(eXtensible Markup Language)是一种广泛使用的标记语言,旨在存储和传输数据。它的设计允许用户定义自己的标记元素,使得 XML 非常适合跨平台的数据交换和文档编制。</p>
|
|||
|
<h3 id="基础语法和结构-2">基础语法和结构<a aria-hidden="true" tabindex="-1" href="#基础语法和结构-2" class="internal"> §</a></h3>
|
|||
|
<p>XML 的基础构造包括:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>标签</strong>:定义开始 <code><tag></code> 和结束 <code></tag></code> 标签。</li>
|
|||
|
<li><strong>属性</strong>:在开始标签中定义,用来存储有关元素的额外信息。</li>
|
|||
|
<li><strong>嵌套</strong>:元素可以包含其他元素,形成复杂的树状结构。</li>
|
|||
|
</ul>
|
|||
|
<p>示例:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="xml" data-theme="default"><code data-language="xml" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);"><</span><span style="color:var(--shiki-token-string-expression);">person</span><span style="color:var(--shiki-color-text);">></span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> <</span><span style="color:var(--shiki-token-string-expression);">name</span><span style="color:var(--shiki-color-text);">>John Doe</</span><span style="color:var(--shiki-token-string-expression);">name</span><span style="color:var(--shiki-color-text);">></span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> <</span><span style="color:var(--shiki-token-string-expression);">age</span><span style="color:var(--shiki-color-text);">>30</</span><span style="color:var(--shiki-token-string-expression);">age</span><span style="color:var(--shiki-color-text);">></span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> <</span><span style="color:var(--shiki-token-string-expression);">address</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">city</span><span style="color:var(--shiki-color-text);">=</span><span style="color:var(--shiki-token-string-expression);">"New York"</span><span style="color:var(--shiki-color-text);"> /></span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"></</span><span style="color:var(--shiki-token-string-expression);">person</span><span style="color:var(--shiki-color-text);">></span></span></code></pre></div>
|
|||
|
<h3 id="应用案例-2">应用案例<a aria-hidden="true" tabindex="-1" href="#应用案例-2" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>企业级系统</strong>:用于配置文件和数据交换。</li>
|
|||
|
<li><strong>Web 服务</strong>:SOAP 协议中通常使用 XML 来编码消息。</li>
|
|||
|
</ul>
|
|||
|
<h2 id="json">JSON<a aria-hidden="true" tabindex="-1" href="#json" class="internal"> §</a></h2>
|
|||
|
<p>JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式,易于人阅读和编写,也易于机器解析和生成。JSON 的设计是为了简化服务器到页面的数据交换,现在被广泛使用于许多编程语言。</p>
|
|||
|
<h3 id="基础语法和结构-3">基础语法和结构<a aria-hidden="true" tabindex="-1" href="#基础语法和结构-3" class="internal"> §</a></h3>
|
|||
|
<p>JSON 主要由两种结构组成:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>对象</strong>:由花括号包围的一组无序的“键/值对”。</li>
|
|||
|
<li><strong>数组</strong>:由方括号包围的值的有序集合。</li>
|
|||
|
</ul>
|
|||
|
<p>示例:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="json" data-theme="default"><code data-language="json" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">{</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"users"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> [</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> {</span><span style="color:var(--shiki-token-keyword);">"name"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"John Doe"</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"age"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">30</span><span style="color:var(--shiki-color-text);">}</span><span style="color:var(--shiki-token-punctuation);">,</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> {</span><span style="color:var(--shiki-token-keyword);">"name"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Jane Smith"</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"age"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">25</span><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> ]</span><span style="color:var(--shiki-token-punctuation);">,</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"settings"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"color"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"blue"</span><span style="color:var(--shiki-token-punctuation);">,</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">"enabled"</span><span style="color:var(--shiki-token-punctuation);">:</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">true</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> }</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div>
|
|||
|
<h3 id="应用案例-3">应用案例<a aria-hidden="true" tabindex="-1" href="#应用案例-3" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>API 数据交换</strong>:广泛用于 Web API 中数据的发送和接收。</li>
|
|||
|
</ul>
|
|||
|
<h2 id="toml">TOML<a aria-hidden="true" tabindex="-1" href="#toml" class="internal"> §</a></h2>
|
|||
|
<p>TOML(Tom’s Obvious, Minimal Language)是一种旨在简单和明确的数据序列化格式。它的设计哲学是易于阅读与编写,且明确无误,常用于配置文件。</p>
|
|||
|
<h3 id="基础语法和结构-4">基础语法和结构<a aria-hidden="true" tabindex="-1" href="#基础语法和结构-4" class="internal"> §</a></h3>
|
|||
|
<p>TOML 支持表格、内联表、数组等结构,语法清晰直观:</p>
|
|||
|
<ul>
|
|||
|
<li><strong>表</strong>:表示为键值对的集合。</li>
|
|||
|
<li><strong>内联表</strong>:在同一行定义完整的表。</li>
|
|||
|
<li><strong>数组</strong>:一系列值,可以包含表或基本数据类型。</li>
|
|||
|
</ul>
|
|||
|
<p>示例:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="toml" data-theme="default"><code data-language="toml" data-theme="default"><span data-line><span style="color:var(--shiki-color-text);">[database]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">server </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"192.168.1.1"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">ports </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> [ </span><span style="color:var(--shiki-token-constant);">8001</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">8001</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">8002</span><span style="color:var(--shiki-color-text);"> ]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">connection_max </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">5000</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">enabled </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">true</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">[clients]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">data </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> [ [</span><span style="color:var(--shiki-token-string-expression);">"gamma"</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"delta"</span><span style="color:var(--shiki-color-text);">]</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-constant);">1</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">2</span><span style="color:var(--shiki-color-text);">] ]</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 内联表</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">owner </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> { name </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Tom Preston-Werner"</span><span style="color:var(--shiki-token-punctuation);">,</span><span style="color:var(--shiki-color-text);"> dob </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> 1979-05-27T07:32:00Z }</span></span></code></pre></div>
|
|||
|
<h3 id="应用案例-4">应用案例<a aria-hidden="true" tabindex="-1" href="#应用案例-4" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>软件项目配置</strong>:如 Rust 项目中 Cargo 的 <code>Cargo.toml</code> 配置文件。</li>
|
|||
|
</ul>
|
|||
|
<h2 id="格式对比">格式对比<a aria-hidden="true" tabindex="-1" href="#格式对比" class="internal"> §</a></h2>
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
<table><thead><tr><th>特征 / 格式</th><th>INI</th><th>YAML</th><th>XML</th><th>JSON</th><th>TOML</th><th>HCL</th><th>CSON</th></tr></thead><tbody><tr><td><strong>易于阅读</strong></td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐</td><td>⭐</td><td>⭐⭐</td><td>⭐⭐⭐⭐</td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐</td></tr><tr><td><strong>易于书写</strong></td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐</td><td>⭐</td><td>⭐⭐</td><td>⭐⭐⭐⭐</td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐</td></tr><tr><td><strong>数据结构</strong></td><td>⭐</td><td>⭐⭐⭐⭐</td><td>⭐⭐⭐⭐⭐</td><td>⭐⭐</td><td>⭐</td><td>⭐⭐⭐⭐</td><td>⭐</td></tr><tr><td><strong>扩展性</strong></td><td>⭐</td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐⭐</td><td>⭐</td><td>⭐⭐⭐</td><td>⭐⭐⭐⭐</td><td>⭐</td></tr><tr><td><strong>注释支持</strong></td><td>✅</td><td>✅</td><td>✅</td><td>❌</td><td>✅</td><td>✅</td><td>✅</td></tr><tr><td><strong>适用场景</strong></td><td>应用程序配置</td><td>DevOps、复杂配置</td><td>企业级数据交换</td><td>Web 应用</td><td>项目配置</td><td>资源描述</td><td>CoffeeScript 环境</td></tr></tbody></table></article></div><div class="right sidebar"><div class="graph "><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{"drag":true,"zoom":true,"depth":1,"scale":1.1,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1,"showTags":true,"removeTags":[]}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
|
|||
|
s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4
|
|||
|
c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562
|
|||
|
C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829
|
|||
|
c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91
|
|||
|
v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4
|
|||
|
s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665
|
|||
|
C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2
|
|||
|
S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4
|
|||
|
s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2
|
|||
|
s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{"drag":true,"zoom":true,"depth":-1,"scale":0.9,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1,"showTags":true,"removeTags":[]}"></div></div></div><div class="toc desktop-only"><button type="button" id="toc" class><h3>Table of Contents</h3><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="fold"><polyline points="6 9 12 15 18 9"></polyline></svg></button><div id="toc-content"><ul class="overflow"><li class="depth-0"><a href="#引言" data-for="引言">引言</a></li><li class="depth-0"><a href="#ini" data-for="ini">INI</a></li><li class="depth-1"><a href="#基础语法和结构" data-for="基础语法和结构">基础语法和结构</a></li><li class="depth-1"><a href="#应用案例" data-for="应用案例">应用案例</a></li><li class="depth-0"><a href="#yaml" data-for="yaml">YAML</a></li><li class="depth-1"><a href="#基础语法和结构-1" data-for="基础语法和结构-1">基础语法和结构</a></li><li class="depth-1"><a href="#应用案例-1" data-for="应用案例-1">应用案例</a></li><li class="depth-0"><a href="#xml" data-for="xml">XML</a></li><li class="depth-1"><a href="#基础语法和结构-2" data-for="基础语法和结构-2">基础语法和结构</a></li><li class="depth-1"><a href="#应用案例-2" data-for="应用案例-2">应用案例</a></li><li class="depth-0"><a href="#json" data-for="json">JSON</a></li><li class="depth-1"><a href="#基础语法和结构-3" data-for="基础语法和结构-3">基础语法和结构</a></li><li class="depth-1"><a href="#应用案例-3" data-for="应用案例-3">应用案例</a></li><li class="depth-0"><a href="#toml" data-for="toml">TOML</a></li><li class="depth-1"><a href="#基础语法和结构-4" data-for="基础语法和结构-4">基础语法和结构</a></li><li class="depth-1"><a href="#应用案例-4" data-for="应用案例-4">应用案例</a></li><li class="depth-0"><a href="#格式对比" data-for="格式对比">格式对比</a></li></ul></div></div><div class="backlinks "><h3>Backlinks</h3><ul class="overflow"><li>No backlinks found</li></ul></div><div class="explorer mobile-only"><button type="button" id="explorer" data-behavior="collapse" data-collapsed="collapsed" data-savestate="true" data-tree="[{"path":"Basics","collapsed":true},{"path":"Basics/english","collapsed":true},{"path":"Blog","collapsed":true},{"path":"Book","collapsed":true},{"path":"Book/个人成长","collapsed":true},{"path":"Book/医学健康","collapsed":true},{"path":"Book/历史","collapsed":true},{"path":"Book/哲学宗教","collapsed":true},{"path":"Book/心理","collapsed":true},{"path":"Book/政治军事","collapsed":true},{"path":"Book/教育学习","collapsed":true},{"path":"Book/文学","collapsed":true},{"path":"Book/生活百科","collapsed":true},{"path":"Book/社会文化","collapsed":true},{"path":"Book/科学技术","collapsed":true},{"path":"Book/经济理财","collapsed":true},{"path":"Book/艺术","collapsed":true},{"path":"Book/计算机","collapsed":true},{"path":"Company","collapsed":true},{"path":"Comp
|
|||
|
function toggleCallout() {
|
|||
|
const outerBlock = this.parentElement;
|
|||
|
outerBlock.classList.toggle(`is-collapsed`);
|
|||
|
const collapsed = outerBlock.classList.contains(`is-collapsed`);
|
|||
|
const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight;
|
|||
|
outerBlock.style.maxHeight = height + `px`;
|
|||
|
let current = outerBlock;
|
|||
|
let parent = outerBlock.parentElement;
|
|||
|
while (parent) {
|
|||
|
if (!parent.classList.contains(`callout`)) {
|
|||
|
return;
|
|||
|
}
|
|||
|
const collapsed2 = parent.classList.contains(`is-collapsed`);
|
|||
|
const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight;
|
|||
|
parent.style.maxHeight = height2 + `px`;
|
|||
|
current = parent;
|
|||
|
parent = parent.parentElement;
|
|||
|
}
|
|||
|
}
|
|||
|
function setupCallout() {
|
|||
|
const collapsible = document.getElementsByClassName(
|
|||
|
`callout is-collapsible`
|
|||
|
);
|
|||
|
for (const div of collapsible) {
|
|||
|
const title = div.firstElementChild;
|
|||
|
if (title) {
|
|||
|
title.removeEventListener(`click`, toggleCallout);
|
|||
|
title.addEventListener(`click`, toggleCallout);
|
|||
|
const collapsed = div.classList.contains(`is-collapsed`);
|
|||
|
const height = collapsed ? title.scrollHeight : div.scrollHeight;
|
|||
|
div.style.maxHeight = height + `px`;
|
|||
|
}
|
|||
|
}
|
|||
|
}
|
|||
|
document.addEventListener(`nav`, setupCallout);
|
|||
|
window.addEventListener(`resize`, setupCallout);
|
|||
|
</script><script type="module">
|
|||
|
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs';
|
|||
|
const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark'
|
|||
|
mermaid.initialize({
|
|||
|
startOnLoad: false,
|
|||
|
securityLevel: 'loose',
|
|||
|
theme: darkMode ? 'dark' : 'default'
|
|||
|
});
|
|||
|
document.addEventListener('nav', async () => {
|
|||
|
await mermaid.run({
|
|||
|
querySelector: '.mermaid'
|
|||
|
})
|
|||
|
});
|
|||
|
</script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="../../../postscript.js" type="module"></script></html>
|