现代配置指南——YAML 比 JSON 高级在哪

一直以来，前端工程中的配置大多都是 .js 文件或者 .json 文件，最常见的比如：

为宁夏等地区用户提供了全套网页设计制作服务，及宁夏网站建设行业解决方案。主营业务为成都网站设计、做网站、宁夏网站设计，以传统方式定制建设网站，并提供域名空间备案等一条龙服务，秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求，就会得到认可，从而选择与我们长期合作。这样，我们也可以走得更远！

这些配置对前端非常友好，因为都是我们熟悉的 JS 对象结构。一般静态化的配置会选择 json 文件，而动态化的配置，涉及到引入其他模块，因此会选择 js 文件。

还有现在许多新工具同时支持多种配置，比如 Eslint ，两种格式的配置任你选择：

后来不知道什么时候，突然出现了一种以 .yaml 或 .yml 为后缀的配置文件。一开始以为是某个程序的专有配置，后来发现这个后缀的文件出现的频率越来越高，甚至 Eslint 也支持了第三种格式的配置 .eslintrc.yml 。

既然遇到了，那就去 探索 它！

下面我们从 YAML 的 出现背景 ， 使用场景 ， 具体用法 ， 高级操作 四个方面，看一下这个流行的现代化配置的神秘之处。

一个新工具的出现避免不了有两个原因：

YAML 这种新工具就属于后者。其实在 yaml 出现之前 js+json 用得也不错，也没什么特别难以处理的问题；但是 yaml 出现以后，开始觉得它好乱呀什么东西，后来了解它后，越用越喜欢，一个字就是优雅。

很多文章说选择 yaml 是因为 json 的各种问题，json 不适合做配置文件，这我觉得有些言过其实了。我更愿意将 yaml 看做是 json 的升级，因为 yaml 在格式简化和体验上表现确实不错，这个得承认。

下面我们对比 YAML 和 JSON，从两方面分析：

JSON 比较繁琐的地方是它严格的格式要求。比如这个对象：

在 JSON 中以下写法通通都是错的：

字符串的值必须 k-v 都是 "" 才行：

虽然是统一格式，但是使用上确实有不便利的地方。比如我在浏览器上测出了接口错误。然后把参数拷贝到 Postman 里调试，这时就我要手动给每个属性和值加 "" 号，非常繁琐。

YAML 则是另辟蹊径，直接把字符串符号干掉了。上面对象的同等 yaml 配置如下：

没错，就这么简单！

除了 "" 号，yaml 觉得 {} 和 [] 这种符号也是多余的，不如一起干掉。

于是呢，以这个对象数组为例：

转换成 yaml 是这样的：

对比一下这个精简程度，有什么理由不爱它？

说起增加的部分，最值得一提的，是 YAML 支持了 注释 。

用 JSON 写配置是不能有注释的，这就意味着我们的配置不会有备注，配置多了会非常凌乱，这是最不人性化的地方。

现在 yaml 支持了备注，以后配置可以是这样的：

把这种配置丢给新同事，还怕他看不懂配了啥吗？

除注释外，还支持配置复用的相关功能，这个后面说。

我接触的第一个 yaml 配置是 Flutter 项目的包管理文件 pubspec.yaml ，这个文件的作用和前端项目中的 package.json 一样，用于存放一些全局配置和应用依赖的包和版本。

看一下它的基本结构：

你看这个结构和 package.json 是不是基本一致？ dependencies 下列出应用依赖和版本， dev_dependencies 下的则是开发依赖。

后来在做 CI/CD 自动化部署的时候，我们用到了 GitHub Action。它需要多个 yaml 文件来定义不同的工作流，这个配置可比 flutter 复杂得多。

其实不光 GitHub Action，其他流行的类似的构建工具如 GitLab CI/CD，circleci，全部都是齐刷刷的 yaml 配置，因此如果你的项目要做 CI/CD 持续集成，不懂 yaml 语法肯定是不行的。

还有，接触过 Docker 的同学肯定知道 Docker Compose，它是 Docker 官方的单机编排工具，其配置文件 docker-compose.yml 也是妥妥的 yaml 格式。现在 Docker 正是如日中天的时候，使用 Docker 必然免不了编排，因此 yaml 语法早晚也要攻克。

上面说的这 3 个案例，几乎都是现代最新最流行的框架/工具。从它们身上可以看出来，yaml 必然是下一代配置文件的标准，并且是 前端-后端-运维 的通用标准。

说了这么多，你跃跃欲试了吗？下面我们详细介绍 yaml 语法。

介绍 yaml 语法会对比 json 解释，以便我们快速理解。

先看一下 yaml 的几个特点：

相比于 JSON 来说，最大的区别是用 缩进 来表示层级，这个和 Python 非常接近。还有强化的一点是支持了注释，JSON 默认是不支持的（虽然 TS 支持），这也对配置文件非常重要。

YAML 支持以下几种数据结构：

先看对象，上一个 json 例子：

转换成 yaml：

对象是最核心的结构，key 值的表示方法是 [key]: ，注意这里 冒号后面有个空格，一定不能少 。value 的值就是一个 纯量 ，且默认不需要引号。

数组和对象的结构差不多，区别是在 key 前用一个 - 符号标识这个是数组项。注意这里 也有一个空格 ，同样也不能少。

转换成 JSON 格式如下：

了解了基本的对象和数组，我们再来看一个复杂的结构。

众所周知，在实际项目配置中很少有简单的对象或数组，大多都是对象和数组相互嵌套而成。在 js 中我们称之为对象数组，而在 yaml 中我们叫 复合结构 。

比如这样一个稍复杂的 JSON：

转换成复合结构的 YAML：

若你想尝试更复杂结构的转换，可以在 这个 网页中在线实践。

纯量比较简单，对应的就是 js 的基本数据类型，支持如下：

比较特殊的两个，null 用 ~ 符号表示，时间大多用 2021-12-21 这种格式表示，如：

转换成 JS 后：

在 yaml 实战过程中，遇到过一些特殊场景，可能需要一些特殊的处理。

在 shell 中我们常见到一些参数很多，然后特别长的命令，如果命令都写在一行的话可读性会非常差。

假设下面的是一条长命令：

在 linux 中可以这样处理：

就是在每行后加 符号标识换行。然而在 YAML 中更简单，不需要加任何符号，直接换行即可：

YAML 默认会把换行符转换成 空格 ，因此转换后 JSON 如下，正是我们需要的：

然而有时候，我们的需求是 保留换行符 ，并不是把它转换成空格，又该怎么办呢？

这个也简单，只需要在首行加一个 | 符号：

转换成 JSON 变成了这样：

获取配置是指，在 YAML 文件中定义的某个配置，如何在代码（JS）里获取？

比如前端在 package.json 里有一个 version 的配置项表示应用版本，我们要在代码中获取版本，可以这么写：

JSON 是可以直接导入的，YAML 可就不行了，那怎么办呢？我们分环境解析：

在浏览器中

浏览器中代码用 webapck 打包，因此加一个 loader 即可：

然后配置 loader：

在组件中使用：

在 Node.js 中

Node.js 环境下没有 Webpack，因此读取 yaml 配置的方法也不一样。

首先安装一个 js-yaml 模块：

然后通过模块提供的方法获取：

配置项复用的意思是，对于定义过的配置，在后面的配置直接引用，而不是再写一遍，从而达到复用的目的。

YAML 中将定义的复用项称为锚点，用 标识；引用锚点则用 * 标识。

对应的 JSON 如下：

但是锚点有个弊端，就是不能作为 变量 在字符串中使用。比如：

此时 key2 的值就是普通字符串 _my name is *name_，引用变得无效了。

其实在实际开发中，字符串中使用变量还是很常见的。比如在复杂的命令中多次使用某个路径，这个时候这个路径就应该是一个变量，在多个命令中复用。

GitHub Action 中有这样的支持，定义一个环境变量，然后在其他的地方复用：

这种实现方式与 webpack 中使用环境变量类似，在构建的时候将变量替换成对应的字符串。

如果本文对你有启发，请甩手一个赞

【百度地图篇】1.Flutter+百度Sdk实现地图功能 & 百度地图显示网格问题

我是初学者小白，所以很多看法不深，理解也不够透彻。但是很适合小白们一起从低角度往高处探索。文中有错误的，感谢指正，一起进步。

趁着假期做一个Flutter的地图功能，因为后端选用了百度地图，所以前端没得挑。找了遍插件，并没有现成可用的。（不过发现了百度官方也自开发Flutter插件，目前功能只有一个获取本地位置信息，后期会继续增加吧？很期待！）

参考帖子：

这个实际上跟功能之间没太大关系，只是我按照个人摸索的过程来写。

当对一个“领域/知识块”完全不懂的时候，360°的方向都不确定的话。先了解基础概念，有利于你确定自己的摸索方向。

参考帖子：

中间我跳过了几十，上百个帖子的摸索过程。这个才是关键能够真正做事的参考。

因为百度的sdk还算是很完善的，所以一旦出问题，都会有对应的报错提示。

我是使用flutter插件：permission_handler，来解决安卓的动态授权问题，用法简单而且设计合理。

这个错误直接来看，就是签名有问题。怎么查看SHA1码和包名，这里不多说，网上有极其多的方法，百度Sdk开发指南里也有。没那么复杂，也没那么麻烦。按照流程操作就是对的。

实在不放心？跟我一样，flutter打包后，把apk反过来解SHA1码不就行了？

参考帖子：

红色框框基本就是帖子讲解的那样。

蓝色框框见下图：release标签里好像是自己设置了。所以debug标签里面，箭头指向的位置，是我多设置的一个参数。

uid: -1 appid -1 msg: httpsPost failed,IOException:Unable to resolve host "api.map.baidu.com": No address associated with hostname

这一步我是哭笑不得，一开始老是和问题（2）混淆，导致浪费很多时间。仔细阅读后，发现是不能连接到“api.map.baidu.com”。

我打开模拟器的chrome浏览器，发现不能上网。查看手机的dns是10.0.2.3(默认的)，和家里wifi不一样，所以不能上网也正常，之前居然没发现这个问题！！！

终端执行：adb shell  和  getprop，就可以查看所有的属性参数了。（window小伙伴自行百度，这个没多大差别。如果你有多个设备，记得自己选好设备。）

在里面找到这一项，就是你的dns参数。有些人是net.dns1，我的是net.eth0.dns1。这个没关系，只是等下指令 稍微改动 就行。

修改dns指令：setprop net.eth0.dns1 192.168.2.1

后面的192.168.2.1是我自己的dns，这个根据自己的情况来填写。不懂的百度下怎么查看自己的dns。

虽然提示设置失败，但是回到模拟器一看，地图已经显示出来了。

嘿嘿，在flutter设定多大的区域，地图就是多大的区域。用起来就很方便了。

过程十分痛苦，因为对flutter不是很熟悉，对Android原生更是了解很少。所以自己就像突然不能讲话，被丢到一个陌生的环境，却要我去找一个人。所以细心很重要，一定要看清楚错误提示，不要错过每一个细节和可能性。

幸好最后解决了问题，开心~

其实如果你仔细阅读过百度官方的文档，会发现里面有关于 地图的生命周期管理 。然后在这里面没有提及到，这一点虽然没提，但不可或缺，小伙伴就自行思考吧。

最后还有一点，其实我的初衷是想实现一个百度地图的plugin，但是苦于能力有限，对Android的不熟悉，最后折戟。我不得已另起项目，然后重新实现地图sdk接入。经过这次对于这些有更多更全面的认知后，有空会再次研究flutter 插件的开发，共勉，奥利给！！！

现在都用什么框架开发软件或网页？

1. Spring

Spring框架是一款功能强大的轻量级Web应用开发框架。面对需要高性能的复杂Web应用需求，Spring能够提供出色的开发服务，因此它在各个框架中能够脱颖而出。Spring框架的核心宗旨是使得Java开发人员可以轻松地创建出企业级的应用程序。

Spring提供了包括：Spring MVC、Spring Core、Spring Security、Spring Transaction、Spring Boost、以及Spring ORM在内的许多模块，以方便企业应用根据实际情况灵活选用。如果您想深入了解其具体的使用场景和用法的话，可以参见《Spring框架注释指南(A Guide to Spring Framework Annotations)》。

优点

它提供了一个轻量级的容器，用户无需使用Web服务器、或应用服务器软件，即可启动之。

由于支持JDBC，因此可提高实际应用的生产率，并减少错误率。

Spring能够同时支持XML，以及基于注释的配置。

它提供了代码的向后兼容性，和可测试性。

2. JSF(Java Server Faces)

由Oracle开发的Java Server Faces(JSF)，可用于创建企业级的应用程序、各种原生应用、以及Web应用的开发。它往往也被用于为基于Java的应用开发用户界面。

作为一款稳定的、且基于组件的MVC框架，JSF具有一种清晰的体系结构，用户可以用它来明确地区分出目标应用的逻辑和表示。

JSF只需通过拖放UI组件，即可帮助开发人员创建用户界面。开发者无需掌握诸如：HTML、CSS、JavaSript之类的高级客户端技术知识，便可用它来简化应用程序的表示层，并进行开发。

优点

JSF是Java EE的组成部分。

它提供了出色的工具和丰富的库。

由于允许用户使用Web界面，来扩展现有的后端Java代码，因此用户不必通过引入新的框架，来更改基本的应用程序。

3. Google Web Toolkit

Google Web Toolkit(GWT)是一个完全免费的，流行且开源的Web框架。它可以帮助开发人员针对Java Ajax应用进行开发和调试。

借助GWT，您可以编写出各种复杂的、基于浏览器的应用程序，而无需具备JavaScript等前端技术方面的专业知识。

当然，GWT也有一些独特的功能，其中包括：跨浏览器的可移植性、历史记录的管理、国际化、以及书签。许多Google产品，包括：AdSense、Google Wallet、以及Blogger都是使用GWT编写的。

优点

开源且完全免费。

对开发人员十分友好。

支持常见的Web开发任务重用。

Google API可以在GWT应用程序中被使用。

提供国际化、跨浏览器的可移植性、UI抽象、书签、以及历史记录管理。

4. Vaadin

Vaadin是一种用于简化Java开发的Web应用框架。它能够方便开发人员构建出自定义的Web开发服务。

该框架的主要优势在于客户端与服务器端之间可以流畅地通信。Vaadin可以从Java虚拟机处直接访问DOM。作为一个轻量级的框架，Vaadin Flow可被用于处理服务器端和客户端之间的路由通信。Vaadin允许开发者将Vaadin组件集成到他们正在使用的任何一款IDE中。由于Vaadin是跨平台类型的框架，因此用户无需将代码迁移到其他的平台上。

在使用Vaadin的过程中，开发人员不需要具有丰富的HTML、CSS、以及JavaScript经验。Vaadin会自动将Java转换为标记。

优点

通过支持拖放、以及其他出色的功能，它简化了Java应用单页UI的创建。

具有WebSocket支持的自动化“服务器端-客户端”通信方式。

使用MVC(Model-View-Controller)或MVP(Model-View-Presenter)，来进行数据绑定。

带有嵌套路由和参数支持的路由器。

支持包括Kotlin和Scala在内的JVM语言。

内置了对于Spring的支持。

5. Hibernate

Hibernate是一个对象关系映射(Object-Relational Mapping，ORM)型数据库，可被用于开发出稳定的Java框架。对象关系映射往往被用于横跨两个不兼容的系统，以连接数据。Hibernate在关系数据库管理系统(relational database management systems，RDBMS)和Java应用程序之间，提供了良好的通信。它非常适合工作在复杂的生态系统中，并对数据流实现无缝化。

在使用诸如Java之类的面向对象的语言时，开发人员往往会遇到被称为“对象关系阻抗不匹配”或“范例不匹配”的问题。Hibernate为开发人员提供了一个可以克服此类问题的框架。

Hibernate的查询与SQL类似，称为HQL(Hibernate查询语言)。Hibernate可以直接将Java类映射到相应的数据库表上，反之亦然。Hibernate在其主文件--hibernate.cfg.xml中，提供了使用数据库配置映射的各种Java类信息。

优点

一种强大的跨数据库解决方案。

可扩展。

数据可以轻松地实现转换。

可配置。

总结

希望上面介绍到的各种最受欢迎的、使用最广泛的Web应用开发Java框架，能够帮助您从易用性、配套文档、以及技术支持等需求维度，选出适合自己实际项目的框架。当然如果您是一名新手，那么我建议从《Java信息图(Java Infographic)》一文，快速熟悉并上手Java。

Flutter 零基础入门实战视频教程（28 个视频）

Flutter 零基础入门实战视频教程 #01 环境搭建 「14:03」

Flutter 零基础入门实战视频教程 #02 Dart 语言 「17:49」

Flutter 零基础入门实战视频教程 #03 建立 Android studio 虚拟设备 「04:12」

Flutter 零基础入门实战视频教程 #04 建立第一个项目 「08:23」

Flutter 零基础入门实战视频教程 #05 安装配置过程中可能遇到的问题（没遇到者可以跳过） 「05:07」

Flutter 零基础入门实战视频教程 #06 运行 iOS 模拟器 「04:07」

Flutter 零基础入门实战视频教程 #07 Flutter 概述 「06:15」

Flutter 零基础入门实战视频教程 #08 Scaffold AppBar 「Pro」「06:50」

Flutter 零基础入门实战视频教程 #09 文档和快捷键 「Pro」「02:36」

Flutter 零基础入门实战视频教程 #10 颜色 Colors 「Pro」「05:47」

Flutter 零基础入门实战视频教程 #11 自定义字体 fonts 「Pro」「05:09」

Flutter 零基础入门实战视频教程 #12 hot reload StatelessWidget 「Pro」「04:56」

Flutter 零基础入门实战视频教程 #13 使用图片 「Pro」「04:59」

Flutter 零基础入门实战视频教程 #14 使用图标 - Icon 「Pro」「01:27」

Flutter 零基础入门实战视频教程 #15 Button 按钮使用指南 「Pro」「04:35」

Flutter 零基础入门实战视频教程 #16 Container 和 Padding 「Pro」「04: 52」

Flutter 零基础入门实战视频教程 #17 Row 「Pro」「05:24」

Flutter 零基础入门实战视频教程 #18 Column 「Pro」「05:36」

Flutter 零基础入门实战视频教程 #19 Flutter Outline Shortcuts 「Pro」「03:18」

Flutter 零基础入门实战视频教程 #20 Expanded Widgets 「Pro」「06:06」

Flutter 零基础入门实战视频教程 #21 实战开始 「Pro」「11:42」

Flutter 零基础入门实战视频教程 #22 换个编辑器 - Visual Studio Code 「Pro」「04:50」

Flutter 零基础入门实战视频教程 #23 Stateful vs Stateless Widget 「Pro」「09:45」

Flutter 零基础入门实战视频教程 #24 列表处理 「Pro」「04:54」

Flutter 零基础入门实战视频教程 #25 自定义 class 「Pro」「05:37」

Flutter 零基础入门实战视频教程 #26 card widget 「Pro」「04:26」

Flutter 零基础入门实战视频教程 #27 Extracting Widgets 「Pro」「06:59」

Flutter 零基础入门实战视频教程 #28 删除 - Functions as Parameters - 完结 - 进入实战课 「Pro」「04:35」

文章名称：flutter指南,flutter flutter
分享地址：http://scyanting.com/article/dsdhcpj.html