sh脚本怎么引入json文件

在Shell脚本中高效引入和处理JSON文件的实用指南

在现代脚本开发中，JSON（JavaScript Object Notation）因其轻量级和易读性成为数据交换的常用格式，传统的Shell脚本（sh）本身并不原生支持JSON解析，本文将介绍几种在sh脚本中引入和处理JSON文件的方法,帮助开发者高效地操作JSON数据。

使用jq工具解析JSON

jq是一个轻量级、灵活的命令行JSON处理器,是处理JSON数据的最佳选择之一。

安装jq

在基于Debian/Ubuntu的系统上：

sudo apt-get install jq

在CentOS/RHEL系统上：

sudo yum install jq

基本使用示例

假设我们有一个名为config.json的文件,内容如下：

{
  "name": "example",
  "version": "1.0",
  "settings": {
    "debug": true,
    "port": 8080
  }
}

在sh脚本中引入并解析这个文件：

#!/bin/sh
# 读取JSON文件
JSON_FILE='config.json'
# 使用jq提取值
name=$(jq -r '.name' "$JSON_FILE")
version=$(jq -r '.version' "$JSON_FILE")
debug=$(jq -r '.settings.debug' "$JSON_FILE")
port=$(jq -r '.settings.port' "$JSON_FILE")
# 使用提取的值
echo "应用名称: $name"
echo "版本: $version"
echo "调试模式: $debug"
echo "端口: $port"
# 条件判断
if [ "$debug" = "true" ]; then
    echo "调试模式已启用"
fi

使用Python作为JSON解析器

如果系统中没有jq或需要更复杂的JSON处理,可以通过调用Python来解析JSON。

示例脚本：

#!/bin/sh
JSON_FILE='config.json'
# 使用Python解析JSON
name=$(python3 -c "import json; f=open('$JSON_FILE'); data=json.load(f); print(data['name'])")
version=$(python3 -c "import json; f=open('$JSON_FILE'); data=json.load(f); print(data['version'])")
echo "名称: $name, 版本: $version"

使用yash或其他支持关联数组的shell

虽然传统的sh不支持关联数组，但一些现代shell如yash或bash（通过#!/bin/bash）支持更复杂的数据结构。

bash示例（需要#!/bin/bash）：

#!/bin/bash
declare -A config
config=$(jq -c '.' config.json)
# 将JSON转换为关联数组
eval "config=($config)"
echo "名称: ${config[name]}"
echo "端口: ${config[settings][port]}"

处理JSON数组

如果JSON文件包含数组,可以这样处理：

#!/bin/sh
JSON_FILE='items.json'
# 假设items.json包含: {"items": ["apple", "banana", "cherry"]}
# 遍历JSON数组
jq -c '.items[]' "$JSON_FILE" | while read item; do
    echo "处理项目: $item"
    # 在这里添加你的处理逻辑
done

最佳实践建议

错误处理：始终检查JSON文件是否存在且格式正确：

if [ ! -f "$JSON_FILE" ]; then
    echo "错误: JSON文件不存在" >&2
    exit 1
fi
if ! jq empty "$JSON_FILE" 2>/dev/null; then
    echo "错误: 无效的JSON格式" >&2
    exit 1
fi

性能考虑：对于大型JSON文件,考虑逐块处理而非一次性加载整个文件。
安全性：当处理来自不可信源的JSON时,注意防止命令注入等安全问题。
脚本可移植性：如果脚本需要在多台机器上运行，确保选择的JSON处理工具（如jq）是预装的可选依赖。

完整示例脚本

下面是一个结合了错误处理和多种JSON操作的完整示例：

#!/bin/sh
# 配置
JSON_FILE='config.json'
# 检查文件存在性
if [ ! -f "$JSON_FILE" ]; then
    echo "错误: 配置文件 $JSON_FILE 不存在" >&2
    exit 1
fi
# 检查JSON有效性
if ! jq empty "$JSON_FILE" 2>/dev/null; then
    echo "错误: $JSON_FILE 包含无效的JSON" >&2
    exit 1
fi
# 提取配置
APP_NAME=$(jq -r '.name // "未命名应用"' "$JSON_FILE")
DEBUG_MODE=$(jq -r '.settings.debug // false' "$JSON_FILE")
PORT=$(jq -r '.settings.port // 8080' "$JSON_FILE")
# 应用配置
echo "启动 $APP_NAME..."
if [ "$DEBUG_MODE" = "true" ]; then
    echo "调试模式已启用，端口: $PORT"
    # 这里可以添加调试相关的启动命令
else
    echo "生产模式，端口: $PORT"
    # 这里可以添加生产环境的启动命令
fi
# 处理配置项
jq -c '.features[]?' "$JSON_FILE" 2>/dev/null | while read feature; do
    feature_name=$(echo "$feature" | jq -r '.name')
    echo "启用功能: $feature_name"
done

通过以上方法，你可以在sh脚本中灵活地引入和处理JSON文件，充分利用JSON的结构化数据优势来增强脚本的功能和可维护性，根据你的具体需求和运行环境,选择最适合的JSON处理方案。