当前位置： 首页 > news >正文

json，一个通用的 Python 库！

news 2026/4/28 8:43:55

【json，一个通用的 Python 库！】

在当今的数字化生活中，数据交换无处不在。无论是你手机上的天气应用从云端拉取实时预报，还是你在电商网站下单后订单系统与仓储系统之间的信息同步，背后都离不开一种轻量、易读且跨语言的数据格式——JSON（JavaScript Object Notation）。而 Python 内置的json标准库，正是我们处理这种格式最锋利、最可靠的瑞士军刀。

想象一下：你写了一个自动化脚本，每天爬取股市收盘价，需要保存到本地供第二天分析；或者你开发了一款桌面便签工具，希望用户的笔记能导出为可移植的文件；又或者你需要调用 ChatGPT 的 API，发送复杂的提示词并解析返回的结构化结果。所有这些场景中，json库都能用寥寥几行代码，将 Python 的字典、列表等原生对象与 JSON 字符串或文件无缝互转。它让“配置持久化”、“API 通信”、“数据日志”变得像呼吸一样自然。

安装库

令人愉悦的是，json是 Python 的标准库，自 Python 2.5 起便内置在解释器中。你无需执行任何pip install操作，只需在代码中直接导入即可：

python

import json

如果你使用的是某些精简版环境（如嵌入式 Python），理论上标准库依然存在。放心，它永远在那里等你。

基本用法

我们通过四个渐进步骤掌握json的核心能力。

1. 将 Python 对象序列化为 JSON 字符串

python

data = { "name": "Alice", "age": 30, "skills": ["Python", "JSON"], "is_active": True } json_str = json.dumps(data, indent=2) # indent 让输出更美观 print(json_str)

输出：

json

{ "name": "Alice", "age": 30, "skills": ["Python", "JSON"], "is_active": true }

2. 将 JSON 字符串反序列化为 Python 对象

python

original = json.loads(json_str) print(original["skills"][0]) # 输出: Python

3. 直接从文件读取 JSON

假设有一个config.json文件：

json

{"theme": "dark", "font_size": 14}

读取代码：

python

with open("config.json", "r", encoding="utf-8") as f: config = json.load(f) print(config["theme"]) # dark

4. 将 Python 对象写入 JSON 文件

python

user_profile = {"username": "bob", "points": 1270} with open("profile.json", "w", encoding="utf-8") as f: json.dump(user_profile, f, indent=2, ensure_ascii=False)

ensure_ascii=False允许写入中文等非 ASCII 字符，否则它们会被转义为\uXXXX。

高级用法

当数据结构中包含datetime、Decimal或自定义类实例时，直接序列化会抛出TypeError。此时你需要自定义编码器。

自定义 JSON 编码器处理日期和时间

python

from datetime import datetime, date import json class CustomEncoder(json.JSONEncoder): def default(self, obj): if isinstance(obj, datetime): return obj.isoformat() if isinstance(obj, date): return obj.isoformat() # 让父类处理其他未知类型 return super().default(obj) data = {"event": "meeting", "time": datetime.now()} json_str = json.dumps(data, cls=CustomEncoder, indent=2) print(json_str)

使用object_hook解码时自动重建对象

当你读取包含 ISO 日期字符串的 JSON 时，可以将其自动转回datetime：

python

def decode_dates(dict_obj): for key, value in dict_obj.items(): if key == "time" and isinstance(value, str): try: dict_obj[key] = datetime.fromisoformat(value) except: pass return dict_obj with open("schedule.json", "r") as f: loaded = json.load(f, object_hook=decode_dates) print(type(loaded["time"])) # <class 'datetime.datetime'>

实际应用场景

场景一：本地待办事项管理工具（深度案例）

日常生活中，我们经常需要一个轻量级的 CLI 待办清单，数据存在本地todo.json文件中。下面是一个完整可运行的示例，包含添加、列出、完成标记功能：

python

import json import os from datetime import datetime TODO_FILE = "todo.json" def load_tasks(): if not os.path.exists(TODO_FILE): return [] with open(TODO_FILE, "r", encoding="utf-8") as f: return json.load(f) def save_tasks(tasks): with open(TODO_FILE, "w", encoding="utf-8") as f: json.dump(tasks, f, indent=2, ensure_ascii=False) def add_task(description): tasks = load_tasks() new_id = max([t["id"] for t in tasks], default=0) + 1 tasks.append({ "id": new_id, "description": description, "completed": False, "created_at": datetime.now().isoformat() }) save_tasks(tasks) print(f"✅ 任务 {new_id} 已添加") def list_tasks(): tasks = load_tasks() if not tasks: print("暂无任务") return for t in tasks: status = "✔" if t["completed"] else "❌" print(f"[{status}] {t['id']}: {t['description']} (创建于 {t['created_at']})") def complete_task(task_id): tasks = load_tasks() for t in tasks: if t["id"] == task_id: t["completed"] = True save_tasks(tasks) print(f"🎉 任务 {task_id} 已完成") return print(f"未找到任务 {task_id}") if __name__ == "__main__": # 简单演示 add_task("学习 json 库的高级用法") add_task("写一篇技术文章") list_tasks() complete_task(1) list_tasks()

场景二：缓存 API 请求结果

很多个人脚本频繁调用免费天气 API，容易被限流。使用 JSON 缓存最近 1 小时的结果：

python

import json import time import requests from functools import wraps CACHE_FILE = "api_cache.json" def cached_api(expire_seconds=3600): def decorator(func): @wraps(func) def wrapper(*args, **kwargs): # 加载已有缓存 try: with open(CACHE_FILE, "r") as f: cache = json.load(f) except (FileNotFoundError, json.JSONDecodeError): cache = {} key = f"{func.__name__}_{args}_{kwargs}" now = time.time() if key in cache and now - cache[key]["timestamp"] < expire_seconds: print("从缓存返回数据") return cache[key]["data"] # 调用真实 API result = func(*args, **kwargs) cache[key] = {"data": result, "timestamp": now} with open(CACHE_FILE, "w") as f: json.dump(cache, f, indent=2) return result return wrapper return decorator @cached_api(expire_seconds=600) def get_weather(city): # 示例：实际应替换为真实 API return {"city": city, "temp": 22, "condition": "sunny"} # 第一次调用会请求，第二次 10 分钟内直接从缓存读取 print(get_weather("Beijing")) print(get_weather("Beijing"))

总结与互动

JSON 作为事实上的数据交换语言，配合 Python 的json库，让开发者能用近乎直觉的方式完成配置管理、本地存储、API 对接等日常工作。从最简单的dumps/loads到自定义编码器和缓存系统，它始终保持着“够用且不复杂”的优雅姿态。掌握json，你就能打通 Python 与外部世界的文本数据管道，让脚本真正融入你的数字化生活。

现在，我想问问你：你在哪个实际项目中因为 JSON 格式不统一或编码错误而踩过坑？或者你是否有更巧妙的json使用技巧（比如与itertools结合处理流式数据）？欢迎在评论区分享你的故事，让我们一起把轻量级数据交换玩出深度！

http://www.jsqmd.com/news/712961/

相关文章：

  • Voxtral-4B-TTS-2603部署教程：CSDN GPU实例安全组开放7860/8000端口实操
  • 如何快速配置ParsecVDisplay：虚拟显示驱动的终极指南
  • 2026年好用的对接精度高的室外移动机器人品牌有哪些，推荐靠谱厂家 - 工业品牌热点
  • HoRain云--PowerShell核心概念全解析
  • 终极游戏操作优化指南：用Hitboxer解决SOCD冲突，释放你的竞技潜能
  • windows MongoDB升级-自动升级脚本-自动检测升级到任意版本
  • 加拿大2026版EE重磅改革！内部官方文件分析！
  • 浙江省CPPM官方报名中心授权机构及联系方式（官方正规报名通道） - 中供国培
  • 如何高效管理Windows驱动存储：DriverStore Explorer完整使用指南
  • SOCD Cleaner终极指南：彻底解决键盘输入冲突，提升游戏操作精度
  • 梳理不需要焊接固定的临边防护品牌，哪个更靠谱 - 工业推荐榜
  • DISCO方法：高效评估机器学习模型的新范式
  • RimSort：告别模组冲突，让你的《边缘世界》体验如丝般顺滑
  • 基于dPanel与OpenClaw的AI智能体：从开发到生产部署全流程指南
  • 3步搞定系统启动盘：Balena Etcher完整指南，告别烧录烦恼
  • Qwen3-Reranker-0.6B应用案例：打造企业知识库智能问答助手
  • 2026前端人必须知道的6个MCP服务器，每一个都能省掉一个工具链
  • 用YOLOv5和LabelImg从零制作FPS游戏数据集（含自动划分脚本）
  • Android 高级工程师面试速记版
  • 企业级门户网站设计与实现：基于SpringBoot + Vue3的全栈解决方案（Day 6）
  • AI时代，大数据驱动内容运营的体系建设
  • LeetCode Kruskal 算法题解
  • SOCD Cleaner：如何用开源工具解决游戏输入冲突，实现亚毫秒级响应
  • CnOpenData 税收调查企业实用新型专利授权质量统计表
  • 【避坑指南】Qwen2.5-VL-7B-Instruct RTX 4090版常见问题与解决方案
  • 【收藏备用】2026年金三银四春招｜AI岗位暴涨12倍，程序员/小白靠大模型逆袭指南
  • 终极指南：5分钟学会用Python一键备份QQ空间所有历史说说
  • OraScan （Oracle碎片扫描工具）使用说明
  • Awesome LLM资源列表：从业者的高效学习与应用导航
  • 为什么 Claude Code 没有一句废话？扒光它的底层提示词，我悟了！