json.dumps() and json.loads() – Fast JSON Processing in Python - DCSoft – Giải pháp công nghệ thông minh cho doanh nghiệp

json.dumps() and json.loads() – Fast JSON Processing in Python

Home
json.dumps() and json.loads() – Fast JSON Processing in Python

by:DCSoftTech Editorial Team November 14, 2026 0 Comments

JSON (JavaScript Object Notation) has become the most popular data exchange format in modern programming. Whether you are building APIs, managing configuration files, or handling NoSQL databases, converting data structures back and forth between Python types (like dicts and lists) and JSON strings is an essential skill.

In Python, the built-in json module provides two core functions to handle this task instantly: json.dumps() and json.loads(). Let’s explore how to use them, their differences, and optimization tips with dcsofttech.

1. Quick Overview: `dumps` vs `loads`

Before diving into the details, remember this simple naming convention in Python:

The letter s at the end stands for string.
Functions with an s (dumps, loads) work directly with strings or bytes.
Functions without an s (dump, load) work directly with files.

Quick summary table:

Function	Full Name	Main Functionality	Conversion Direction
`json.dumps()`	JSON Dump String	Convert a Python object into a JSON string	Python Object $\rightarrow$ JSON String
`json.loads()`	JSON Load String	Parse a JSON string into a Python object	JSON String $\rightarrow$ Python Object

2. `json.dumps()` – Serializing Python Data to JSON Strings

The json.dumps() function (Serialization/Encoding) is used to convert basic Python data types (dictionary, list, string, int, float, boolean, None) into a standard JSON-formatted string.

Basic Syntax

Python

import json

data = {
    "id": 101,
    "name": "DC SoftTech",
    "active": True,
    "skills": ["Python", "Django", "FastAPI"]
}

# Convert dictionary to JSON string
json_string = json.dumps(data)
print(json_string)
# Output: {"id": 101, "name": "DC SoftTech", "active": true, "skills": ["Python", "Django", "FastAPI"]}

Advanced Parameters for Better Formatting

By default, the JSON string from dumps() is compact and hard to read. You can optimize it using these parameters:

indent: Adds indentation for a clean, readable output (pretty-print).
ensure_ascii=False: Ensures special characters (or non-ASCII alphabets) are displayed correctly instead of unicode escapes like \uXXXX.
sort_keys=True: Sorts the dictionary keys alphabetically.

Python

formatted_json = json.dumps(data, indent=4, ensure_ascii=False, sort_keys=True)
print(formatted_json)

Output:

JSON

{
    "active": true,
    "id": 101,
    "name": "DC SoftTech",
    "skills": [
        "Python",
        "Django",
        "FastAPI"
    ]
}

3. `json.loads()` – Deserializing JSON Strings to Python Objects

Conversely, the json.loads() function (Deserialization/Decoding) takes a valid JSON-formatted string (or bytes) and parses it into corresponding Python objects (primarily dicts and lists).

Basic Syntax

Python

import json

json_data = '{"id": 101, "name": "DC SoftTech", "active": true, "skills": ["Python", "FastAPI"]}'

# Convert JSON string to Python dictionary
python_obj = json.loads(json_data)

print(type(python_obj))  # <class 'dict'>
print(python_obj["name"]) # DC SoftTech
print(python_obj["skills"][0]) # Python

Handling Errors (`JSONDecodeError`)

When receiving JSON data from external sources (like third-party APIs or user configurations), the JSON string might have syntax errors (e.g., missing quotes, trailing commas). It is best practice to wrap json.loads() in a try-except block:

Python

import json

bad_json = '{"name": "DC SoftTech", "active": true,}' # Trailing comma error

try:
    data = json.loads(bad_json)
except json.JSONDecodeError as e:
    print(f"JSON syntax error: {e}")

4. Data Type Mapping Table

When converting between Python and JSON, types map as follows:

Python	JSON
`dict`	`object`
`list`, `tuple`	`array`
`str`	`string`
`int`, `float`	`number`
`True` / `False`	`true` / `false`
`None`	`null`

Note: Tuples in Python are converted into JSON arrays ([]) when passed through dumps().

5. Pro Tips for Handling JSON Efficiently

Handling Complex Objects (like Datetime): By default, json.dumps() raises a TypeError if it encounters unsupported data types like datetime. You can pass a default function to resolve this:
Python
```
import json
from datetime import datetime

data = {"time": datetime.now()}

# Use str or a custom handler function
json_str = json.dumps(data, default=str)
print(json_str)
```

Working Directly with Files (json.dump and json.load): Instead of reading file content into a string variable and then calling loads(), use json.load() directly to save memory:

Python

# Read a JSON file
with open('config.json', 'r', encoding='utf-8') as f:
    config = json.load(f)

# Write to a JSON file
with open('output.json', 'w', encoding='utf-8') as f:
    json.dump(data, f, indent=4, ensure_ascii=False)

Conclusion

Mastering json.dumps() and json.loads() helps you optimize data processing speed, keep your codebase clean, and avoid formatting errors in Python. Apply parameters like ensure_ascii=False and indent to make your applications more professional and maintainable!

M	T	W	T	F	S	S
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30

About Us

Contact Info