快捷導(dǎo)航

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

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

本文介紹了在Python中檢查JSON文件語法的多種方法,包括使用標準庫json、jsonschema進行結(jié)構(gòu)驗證、使用json.tool命令行工具以及編寫完整的驗證函數(shù),推薦使用內(nèi)置的json模塊,因為它簡單、可靠且無需額外依賴,對于復(fù)雜項目,可以結(jié)合jsonschema進行結(jié)構(gòu)驗證

1. 使用標準庫 json（推薦）

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

import json

def validate_json_file(file_path):
    """
    驗證JSON文件語法是否正確
    """
    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} 包含語法錯誤:")
        print(f"   錯誤位置: 第{e.lineno}行, 第{e.colno}列")
        print(f"   錯誤信息: {e.msg}")
        return False
    except FileNotFoundError:
        print(f"? 文件 {file_path} 不存在")
        return False

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

2. 使用 jsonschema 進行結(jié)構(gòu)驗證（高級）

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

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驗證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ù)驗證失敗: {e.message}")
        return False
    except json.JSONDecodeError as e:
        print(f"? JSON語法錯誤: {e}")
        return False

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

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

Python還提供了命令行工具來驗證和格式化JSON：

# 驗證JSON文件
python -m json.tool data.json

# 如果JSON無效，會顯示錯誤信息
# 如果有效，會輸出格式化后的JSON

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

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

import json
import os

def comprehensive_json_validation(file_path, schema=None):
    """
    綜合的JSON文件驗證
    """
    # 檢查文件是否存在
    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} - 語法驗證通過")
        
        # 可選：schema驗證
        if schema:
            try:
                from jsonschema import validate
                validate(instance=data, schema=schema)
                print(f"? {file_path} - 結(jié)構(gòu)驗證通過")
            except ImportError:
                print("??  未安裝jsonschema庫，跳過結(jié)構(gòu)驗證")
            except Exception as e:
                print(f"? 結(jié)構(gòu)驗證失敗: {e}")
                return False
        
        return True
        
    except json.JSONDecodeError as e:
        print(f"? JSON語法錯誤:")
        print(f"   位置: 第{e.lineno}行, 第{e.colno}列")
        print(f"   錯誤: {e.msg}")
        
        # 提供更詳細的錯誤上下文
        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"   錯誤行: {error_line.rstrip()}")
                print(f"   {' ' * (e.colno - 1)}^")
        
        return False
    except UnicodeDecodeError:
        print(f"? 文件編碼錯誤，請使用UTF-8編碼")
        return False

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

5. 批量驗證多個文件

import glob

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

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