快捷導(dǎo)航

Python檢查JSON文件語(yǔ)法的多種實(shí)現(xiàn)方法

更新時(shí)間：2025年12月31日 09:32:55 作者：江上清風(fēng)山間明月

本文介紹了在Python中檢查JSON文件語(yǔ)法的多種方法,包括使用標(biāo)準(zhǔn)庫(kù)json、jsonschema進(jìn)行結(jié)構(gòu)驗(yàn)證、使用json.tool命令行工具以及編寫完整的驗(yàn)證函數(shù),推薦使用內(nèi)置的json模塊,因?yàn)樗?jiǎn)單、可靠且無(wú)需額外依賴,對(duì)于復(fù)雜項(xiàng)目,可以結(jié)合jsonschema進(jìn)行結(jié)構(gòu)驗(yàn)證

1. 使用標(biāo)準(zhǔn)庫(kù) json（推薦）

Python內(nèi)置的json模塊是最簡(jiǎn)單直接的方法：

import json

def validate_json_file(file_path):
    """
    驗(yàn)證JSON文件語(yǔ)法是否正確
    """
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            json.load(f)
        print(f"? {file_path} 是有效的JSON文件")
        return True
    except json.JSONDecodeError as e:
        print(f"? {file_path} 包含語(yǔ)法錯(cuò)誤:")
        print(f"   錯(cuò)誤位置: 第{e.lineno}行, 第{e.colno}列")
        print(f"   錯(cuò)誤信息: {e.msg}")
        return False
    except FileNotFoundError:
        print(f"? 文件 {file_path} 不存在")
        return False

# 使用示例
validate_json_file('data.json')

2. 使用 jsonschema 進(jìn)行結(jié)構(gòu)驗(yàn)證（高級(jí)）

如果需要驗(yàn)證JSON的結(jié)構(gòu)而不僅僅是語(yǔ)法，可以使用jsonschema庫(kù)：

pip install jsonschema

import json
import jsonschema
from jsonschema import validate

# 定義JSON schema
schema = {
    "type": "object",
    "properties": {
        "name": {"type": "string"},
        "age": {"type": "number", "minimum": 0},
        "email": {"type": "string", "format": "email"}
    },
    "required": ["name", "age"]
}

def validate_json_with_schema(file_path, schema):
    """
    使用schema驗(yàn)證JSON文件結(jié)構(gòu)和內(nèi)容
    """
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            data = json.load(f)
        
        validate(instance=data, schema=schema)
        print(f"? {file_path} 符合schema定義")
        return True
        
    except jsonschema.ValidationError as e:
        print(f"? 數(shù)據(jù)驗(yàn)證失敗: {e.message}")
        return False
    except json.JSONDecodeError as e:
        print(f"? JSON語(yǔ)法錯(cuò)誤: {e}")
        return False

# 使用示例
validate_json_with_schema('user.json', schema)

3. 使用 json.tool 命令行工具

Python還提供了命令行工具來(lái)驗(yàn)證和格式化JSON：

# 驗(yàn)證JSON文件
python -m json.tool data.json

# 如果JSON無(wú)效，會(huì)顯示錯(cuò)誤信息
# 如果有效，會(huì)輸出格式化后的JSON

4. 完整的驗(yàn)證函數(shù)

下面是一個(gè)功能更完整的驗(yàn)證函數(shù)：

import json
import os

def comprehensive_json_validation(file_path, schema=None):
    """
    綜合的JSON文件驗(yàn)證
    """
    # 檢查文件是否存在
    if not os.path.exists(file_path):
        print(f"? 文件 {file_path} 不存在")
        return False
    
    # 檢查文件是否為空
    if os.path.getsize(file_path) == 0:
        print(f"? 文件 {file_path} 為空")
        return False
    
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            data = json.load(f)
        
        print(f"? {file_path} - 語(yǔ)法驗(yàn)證通過(guò)")
        
        # 可選：schema驗(yàn)證
        if schema:
            try:
                from jsonschema import validate
                validate(instance=data, schema=schema)
                print(f"? {file_path} - 結(jié)構(gòu)驗(yàn)證通過(guò)")
            except ImportError:
                print("??  未安裝jsonschema庫(kù)，跳過(guò)結(jié)構(gòu)驗(yàn)證")
            except Exception as e:
                print(f"? 結(jié)構(gòu)驗(yàn)證失敗: {e}")
                return False
        
        return True
        
    except json.JSONDecodeError as e:
        print(f"? JSON語(yǔ)法錯(cuò)誤:")
        print(f"   位置: 第{e.lineno}行, 第{e.colno}列")
        print(f"   錯(cuò)誤: {e.msg}")
        
        # 提供更詳細(xì)的錯(cuò)誤上下文
        with open(file_path, 'r', encoding='utf-8') as f:
            lines = f.readlines()
            if e.lineno <= len(lines):
                error_line = lines[e.lineno - 1]
                print(f"   錯(cuò)誤行: {error_line.rstrip()}")
                print(f"   {' ' * (e.colno - 1)}^")
        
        return False
    except UnicodeDecodeError:
        print(f"? 文件編碼錯(cuò)誤，請(qǐng)使用UTF-8編碼")
        return False

# 使用示例
comprehensive_json_validation('data.json')

5. 批量驗(yàn)證多個(gè)文件

import glob

def validate_multiple_json_files(pattern):
    """
    批量驗(yàn)證多個(gè)JSON文件
    """
    files = glob.glob(pattern)
    results = {}
    
    for file_path in files:
        print(f"\n正在驗(yàn)證: {file_path}")
        is_valid = validate_json_file(file_path)
        results[file_path] = is_valid
    
    print(f"\n驗(yàn)證結(jié)果匯總:")
    for file_path, is_valid in results.items():
        status = "? 有效" if is_valid else "? 無(wú)效"
        print(f"  {file_path}: {status}")
    
    return results

# 驗(yàn)證所有.json文件
validate_multiple_json_files("*.json")