企业官网建设流程全解析

Jsonnet介绍

Jsonnet 是一种领域特定语言（DSL），用于以结构化、可编程的方式生成JSON（以及兼容格式如 YAML、TOML）。它由 Google 开发，旨在解决纯 JSON 在配置管理、模板复用和逻辑表达方面的不足。

一、Jsonnet 的核心特点

1. 基于 JSON 扩展：Jsonnet 可以看作“带逻辑的 JSON”——所有合法的 JSON 也是合法的 Jsonnet，但 Jsonnet 支持变量、函数、条件、继承、模块化等。
2. 不可变数据结构：强调函数式编程风格，变量一旦赋值不可更改，避免副作用。
3. 延迟求值（Lazy Evaluation）：字段只有在被引用时才计算，提高效率并支持灵活的依赖关系。
4. 强大的对象模型：支持对象继承（+:、::、+::等操作符）、隐藏字段（::为私有）、局部作用域（local）。
5. 标准库丰富：内置std库，提供字符串处理、数组/对象操作、数学函数等。
6. 可生成多种格式：通过工具可输出 JSON、YAML、甚至文本（如配置文件、SQL、代码模板等）。

二、基本语法示例

1. 变量与局部作用域

local name = "alice"; { user: name, id: 1001 }

2. 函数

local greeting(person) = "Hello, " + person + "!"; { message: greeting("Bob") }

3. 条件表达式

local env = "prod"; { db_url: if env == "prod" then "db.prod.example.com" else "db.dev.example.com" }

4. 对象继承与覆盖

local baseConfig = { port: 8080, timeout: 30, debug:: false // 私有字段，不会出现在最终 JSON 中 }; { dev: baseConfig { port: 8081, debug:: true } }

5. 数组与列表推导

local services = ["web", "api", "db"]; { containers: [ { name: s, image: s + ":latest" } for s in services ] }

三、典型使用场景

✅ 配置文件管理（如 Kubernetes、Terraform）

• 避免重复配置（DRY）
• 多环境（dev/staging/prod）复用同一模板
• 示例：Tanka 就是基于 Jsonnet 的 Kubernetes 配置工具

✅ 生成结构化数据（JSON/YAML）

• 用于 CI/CD、测试数据生成、API mock 等

✅ 构建复杂模板（如代码生成、SQL 模板）

• 结合std.manifestJsonEx、std.manifestYamlDoc等函数输出所需格式

四、工具链与使用方式

安装 Jsonnet

# macOS (Homebrew)brewinstalljsonnet# Linux (Debian/Ubuntu)sudoapt-getinstalljsonnet# 或从源码编译（Go 实现：go-jsonnet，性能更好）goinstallgithub.com/google/go-jsonnet/cmd/jsonnet@latest

命令行使用

# 生成 JSONjsonnet config.jsonnet# 生成 YAMLjsonnet --yaml-stream config.jsonnet# 格式化jsonnetfmt -i config.jsonnet

与构建系统集成

• 可在 Makefile、Bazel、CMake（通过add_custom_command）中调用jsonnet生成配置

五、进阶技巧

• 模块化：使用import "file.libsonnet"复用代码
• 标准库：std.map,std.filter,std.toString,std.base64,std.parseJson等
• 错误处理：error "message"抛出错误
• 字符串插值："Port is %d" % port
• 输出非 JSON 文本：使用std.manifestText或自定义模板

示例：生成 YAML 配置

local cfg = { apiVersion: "v1", kind: "ConfigMap", metadata: { name: "app-config" }, data: { ENV: "production", LOG_LEVEL: "info" } }; std.manifestYamlDoc(cfg) // 注意：需用 `jsonnet --yaml-stream`

六、学习资源

• 官网：https://jsonnet.org/
• 交互式教程：https://jsonnet.org/learning/tutorial.html
• 标准库文档：https://jsonnet.org/ref/stdlib.html
• GitHub：https://github.com/google/jsonnet

Jsonnet高级概念

Jsonnet 是一种功能强大的结构化配置语言，它扩展了 JSON，提供了模块化、可重用性和表达能力，广泛用于配置管理、Kubernetes 清单生成等场景。以下是 Jsonnet 的几个高级概念，特别针对你关心的文件包含和注释功能：

1.文件包含（Import）

Jsonnet 支持通过import和importstr机制包含其他文件，实现模块化和配置复用。

• import "file.jsonnet"
  导入另一个 Jsonnet 文件，并将其求值结果作为表达式使用（通常是对象或函数）。

  // config.libsonnet { commonPort: 8080, server(name): { name: name, port: $.commonPort } } // main.jsonnet local lib = import "config.libsonnet"; { api: lib.server("api"), web: lib.server("web") }

• importstr "file.txt"
  以原始字符串形式导入文件内容（不解析为 Jsonnet），常用于嵌入模板、脚本或非结构化文本。

  local script = importstr "init.sh"; { initScript: script }

Jsonnet 的 import 路径是相对于当前文件的，也支持通过-J或--jpath指定额外的搜索路径。

2.注释（Comments）

Jsonnet 完全支持类似 C/C++ 的注释语法：

• 单行注释：// This is a comment
• 多行注释：/* This is a multi-line comment */

这些注释在 Jsonnet 被编译为 JSON 后会自动被剥离，不会出现在输出中，因此不影响最终 JSON 的合法性。

{ // 服务端口配置 port: 8080, /* 启用调试模式？ 仅在开发环境使用 */ debug: false }

⚠️ 注意：原始 JSON 不支持注释，但 Jsonnet 作为超集语言，允许在源码中使用注释，这是它优于纯 JSON 的一大优势。

3.其他高级特性（简要）

4.与 JSON 的兼容性

• 所有合法的 JSON 文件也是合法的 Jsonnet 文件（但反之不成立）。
• Jsonnet 编译后输出标准 JSON，可被任何 JSON 工具消费。

5.典型使用场景

• Kubernetes Helm 替代方案（如 Tanka）
• 多环境配置管理（dev/staging/prod）
• 大型系统中复用配置片段