simplejson 是一个高性能、纯 Python 实现的 JSON 编码器和解码器，它是 Python 标准库中 json 模块的一个替代品，通常被认为在处理大型 JSON 数据或需要更高性能的场景下表现更优。

为什么使用 simplejson？

在安装之前,了解它的优点很重要：

• 性能更高：simplejson 的核心编码和解码算法经过高度优化，在处理大量数据时，速度通常比标准库的 json 模块快。
• 功能更全：simplejson 的 API 与标准 json 模块兼容，但有时会提供更多额外的功能或更早支持新的 JSON 规范特性。
• Python 标准库的基石：有趣的是，Python 2.6 及更高版本的标准库 json 模块，其最初的实现就是基于 simplejson 的，它们的 API 非常相似。

什么时候应该使用它？

• 当你处理非常大的 JSON 文件或数据流,性能成为瓶颈时。
• 当你的项目依赖于 simplejson 的特定高级功能时。
• 在某些旧版 Python 环境中，标准库的 json 模块可能不存在或功能不完善，simplejson 是一个可靠的替代品。

对于大多数日常应用，Python 自带的 json 模块已经足够好且无需额外安装。

安装 simplejson

安装 simplejson 非常简单，通常使用 pip（Python 的包安装器）即可完成。

使用 pip（推荐）

打开你的终端或命令行工具（Windows 上是 CMD 或 PowerShell，macOS/Linux 上是 Terminal）,然后运行以下命令：

pip install simplejson

注意事项：

• 权限问题：如果你遇到权限错误（Permission denied），你可能需要使用 sudo（在 macOS/Linux 上）或者以管理员身份运行命令提示符（在 Windows 上）。

  # macOS / Linux
  sudo pip install simplejson
  # Windows (以管理员身份打开 CMD)
  pip install simplejson

• Python 版本：如果你系统中有多个 Python 版本（Python 2 和 Python 3），你可能需要指定 pip 的版本。

  
  （图片来源网络，侵删）

  # 针对 Python 3
  pip3 install simplejson
  # 针对 Python 2 (如果仍在使用)
  pip2 install simplejson

• 虚拟环境：最佳实践是始终在虚拟环境中安装和管理 Python 包,这可以避免不同项目之间的包冲突。

  # 1. 创建虚拟环境 (名为 venv)
  python -m venv venv
  # 2. 激活虚拟环境
  # Windows
  .\venv\Scripts\activate
  # macOS / Linux
  source venv/bin/activate
  # 3. 在激活的环境中安装 simplejson
  pip install simplejson

从源码安装

如果你需要安装最新开发版或者想进行自定义修改,可以从源码安装。

1. 克隆仓库：

   git clone https://github.com/simplejson/simplejson.git

2. 进入目录：

   cd simplejson

3. 安装：

   pip install .

   或者使用 setup.py：

   python setup.py install

如何使用 simplejson

simplejson 的使用方法与标准库的 json 模块几乎完全相同，只需要将 import json 替换为 import simplejson 即可。

基本示例

下面是一个简单的编码（将 Python 对象转为 JSON 字符串）和解码（将 JSON 字符串转为 Python 对象）的例子。

编码 (Python 对象 -> JSON 字符串)

import simplejson as json
# 一个 Python 字典
data = {
    "name": "张三",
    "age": 30,
    "is_student": False,
    "courses": ["Python", "数据分析"],
    "address": {
        "city": "北京",
        "district": "海淀区"
    }
}
# 将 Python 对象转换为 JSON 格式的字符串
# ensure_ascii=False 确保中文字符不被转义
json_string = json.dumps(data, ensure_ascii=False, indent=4)
print("生成的 JSON 字符串:")
print(json_string)

输出：

生成的 JSON 字符串:
{
    "name": "张三",
    "age": 30,
    "is_student": false,
    "courses": [
        "Python",
        "数据分析"
    ],
    "address": {
        "city": "北京",
        "district": "海淀区"
    }
}

解码 (JSON 字符串 -> Python 对象)

import simplejson as json
# 上一步生成的 JSON 字符串
json_string = """
{
    "name": "张三",
    "age": 30,
    "is_student": false,
    "courses": [
        "Python",
        "数据分析"
    ],
    "address": {
        "city": "北京",
        "district": "海淀区"
    }
}
"""
# 将 JSON 字符串转换为 Python 对象 (字典)
python_object = json.loads(json_string)
print("解析后的 Python 对象:")
print(python_object)
# 访问解析后的数据
print("\n访问特定数据:")
print(f"姓名: {python_object['name']}")
print(f"第一个课程: {python_object['courses'][0]}")

输出：

解析后的 Python 对象:
{'name': '张三', 'age': 30, 'is_student': False, 'courses': ['Python', '数据分析'], 'address': {'city': '北京', 'district': '海淀区'}}
访问特定数据:
姓名: 张三
第一个课程: Python

simplejson 与 json 模块的切换

因为它们的 API 兼容,所以你可以非常轻松地在两者之间切换。

场景：你正在维护一个旧项目，它使用了 simplejson，但你希望将来迁移到标准库。

你可以这样做：

try:
    # 尝试导入 simplejson，如果项目已安装，则使用它
    import simplejson as json
except ImportError:
    # simplejson 未安装，则回退到标准库
    import json
# 接下来的代码完全一样，无需任何修改
data = {"key": "value"}
json_string = json.dumps(data)
parsed_data = json.loads(json_string)
print(f"使用的是 {json.__name__} 模块")

这样做可以确保你的代码在有 simplejson 的环境中享受其性能优势，在没有它的环境中（如一个全新的、干净的 Python 安装）也能正常工作。

1. 安装：使用 pip install simplejson。
2. 使用：import simplejson as json，然后像使用标准 json 模块一样使用 dumps() 和 loads()。
3. 优势：主要优势是性能，适用于处理大型 JSON 数据。
4. 兼容性：API 与标准库 json 模块高度兼容,可以无缝切换。

希望这份详细的指南能帮助你成功安装和使用 simplejson！