介绍
Python 是一门强大的编程语言，但即使是经验丰富的开发者，在开发过程中也会遇到错误。初学者常遇到的一个错误是，在尝试处理 JSON 数据时出现的 NameError: name 'json' is not defined 错误。本教程将指导你理解、复现和解决这个错误，以确保你的 Python 代码顺利运行。
通过完成这个实验（Lab），你将理解这个错误发生的原因，并学习在你的 Python 应用中正确导入和使用 JSON 模块的方法。
理解 Python 的 NameError
Python 中的 NameError 错误，发生在解释器无法找到你试图使用的变量、函数或模块时。这个错误通常由以下原因之一引起：
- 在使用变量之前没有定义它
- 拼写错误，导致变量或函数名称错误
- 在使用模块之前忘记导入它
探索一个简单的 NameError 示例
让我们从创建一个生成 NameError 的简单脚本开始。打开代码编辑器，在 /home/labex/project 目录下创建一个名为 name_error_example.py 的新文件，内容如下：
## This script demonstrates a simple NameError
print("Starting the script...")
## Try to use a variable that hasn't been defined
print(undefined_variable)
print("This line won't execute because of the error above")现在，让我们运行这个脚本。打开一个终端并执行：
python3 /home/labex/project/name_error_example.py你应该看到类似如下的输出：
Starting the script...
Traceback (most recent call last):
File "/home/labex/project/name_error_example.py", line 5, in <module>
print(undefined_variable)
NameError: name 'undefined_variable' is not defined这个错误消息告诉我们：
- 错误类型：
NameError - 具体问题：
name 'undefined_variable' is not defined - 位置：脚本中的第 5 行
Python 解释器抛出这个错误，是因为我们试图使用一个名为 undefined_variable 的变量，但没有先定义它。这与在没有导入 json 模块的情况下尝试使用它时发生的错误类型相同。
复现 JSON 的 NameError
现在我们已经理解了什么是 NameError，让我们来复现标题中提到的具体错误：NameError: name 'json' is not defined。
创建一个包含 JSON 错误的脚本
在 /home/labex/project 目录下创建一个名为 json_error.py 的新文件，内容如下：
## This script tries to use the json module without importing it
## Sample JSON string
json_string = '{"name": "Alice", "age": 30, "city": "New York"}'
## Try to parse JSON without importing the json module
parsed_data = json.loads(json_string)
print("User data:", parsed_data)在这个脚本中，我们试图使用 json.loads() 函数来解析一个 JSON 字符串，但我们还没有先导入 json 模块。
让我们运行这个脚本，看看会发生什么：
python3 /home/labex/project/json_error.py你应该看到类似这样的错误消息：
Traceback (most recent call last):
File "/home/labex/project/json_error.py", line 7, in <module>
parsed_data = json.loads(json_string)
NameError: name 'json' is not defined这正是我们在这个实验（Lab）中试图解决的错误！Python 解释器找不到 json 模块，因为我们在尝试使用它之前没有导入它。
理解 JSON 模块
在我们修复这个错误之前，让我们先理解一下 JSON 模块是什么：
- JSON（JavaScript Object Notation）是一种轻量级的数据交换格式
- Python 包含一个内置的
json模块来处理 JSON 数据 json模块提供了将 Python 对象编码为 JSON 字符串，以及将 JSON 字符串解码为 Python 对象的方法- 常用函数包括
json.dumps()（将 Python 转换为 JSON）和json.loads()（将 JSON 转换为 Python）
与所有 Python 模块一样，你需要先导入 json 模块，然后才能使用它的函数。
修复 JSON 的 NameError
现在我们已经复现了错误，让我们通过正确导入 JSON 模块来修复它。
添加导入语句
打开 json_error.py 文件，并通过在顶部添加一个导入语句来更新它：
## This script properly uses the json module by importing it first
import json
## Sample JSON string
json_string = '{"name": "Alice", "age": 30, "city": "New York"}'
## Parse JSON after importing the json module
parsed_data = json.loads(json_string)
print("User data:", parsed_data)关键的改变是在文件开头添加了 import json。这告诉 Python 在我们尝试使用 JSON 模块之前先加载它。
运行已修复的脚本
保存文件并再次运行它：
python3 /home/labex/project/json_error.py这次，你应该看到脚本成功执行，并输出：
User data: {'name': 'Alice', 'age': 30, 'city': 'New York'}脚本现在运行没有错误，因为我们在使用 json 模块之前已经正确地导入了它。
替代导入方法
在 Python 中，有几种导入模块的方法：
-
导入整个模块（如上所述）：
import json ## Use as json.function_name() -
从模块中导入特定函数：
from json import loads ## Use directly as loads() -
使用别名导入：
import json as j ## Use as j.function_name()
让我们尝试第二种方法。创建一个名为 json_import_variation.py 的新文件，内容如下：
## Importing specific functions from the json module
from json import loads
## Sample JSON string
json_string = '{"name": "Bob", "age": 25, "city": "San Francisco"}'
## Parse JSON using the directly imported function
parsed_data = loads(json_string)
print("User data:", parsed_data)运行这个脚本，看看它是否也有效：
python3 /home/labex/project/json_import_variation.py你应该看到：
User data: {'name': 'Bob', 'age': 25, 'city': 'San Francisco'}这表明有多种有效的导入 JSON 模块的方法，所有这些方法都将防止 NameError 的发生。
处理 JSON 数据
现在我们知道了如何正确导入 JSON 模块，让我们来探索如何使用它进行常见的 JSON 操作。
创建一个完整的 JSON 示例
创建一个名为 json_operations.py 的新文件，内容如下：
## Complete example of working with JSON in Python
import json
## 1. Converting Python object to JSON string (serialization)
user = {
"name": "Charlie",
"age": 28,
"is_student": False,
"courses": ["Python", "Data Science", "Web Development"],
"address": {
"street": "123 Tech Lane",
"city": "Boston",
"zipcode": "02101"
}
}
## Convert Python dictionary to JSON string
json_string = json.dumps(user, indent=2)
print("JSON string created from Python object:")
print(json_string)
print("\n" + "-"*50 + "\n")
## 2. Parse JSON string to Python object (deserialization)
parsed_user = json.loads(json_string)
print("Python object created from JSON string:")
print("Name:", parsed_user["name"])
print("Age:", parsed_user["age"])
print("Courses:", parsed_user["courses"])
print("City:", parsed_user["address"]["city"])
print("\n" + "-"*50 + "\n")
## 3. Writing JSON to a file
with open("/home/labex/project/user_data.json", "w") as json_file:
json.dump(user, json_file, indent=2)
print("JSON data written to user_data.json")
## 4. Reading JSON from a file
with open("/home/labex/project/user_data.json", "r") as json_file:
loaded_user = json.load(json_file)
print("JSON data loaded from file. User name:", loaded_user["name"])这个脚本演示了四个常见的 JSON 操作：
- 使用
json.dumps()将 Python 对象转换为 JSON 字符串 - 使用
json.loads()将 JSON 字符串解析为 Python 对象 - 使用
json.dump()将 JSON 数据写入文件 - 使用
json.load()从文件中读取 JSON 数据
运行脚本：
python3 /home/labex/project/json_operations.py你应该看到类似这样的输出：
JSON string created from Python object:
{
"name": "Charlie",
"age": 28,
"is_student": false,
"courses": [
"Python",
"Data Science",
"Web Development"
],
"address": {
"street": "123 Tech Lane",
"city": "Boston",
"zipcode": "02101"
}
}
--------------------------------------------------
Python object created from JSON string:
Name: Charlie
Age: 28
Courses: ['Python', 'Data Science', 'Web Development']
City: Boston
--------------------------------------------------
JSON data written to user_data.json
JSON data loaded from file. User name: Charlie该脚本还创建了一个名为 user_data.json 的文件。让我们看看它的内容：
cat /home/labex/project/user_data.json你应该看到格式正确的 JSON 数据，带有适当的缩进：
{
"name": "Charlie",
"age": 28,
"is_student": false,
"courses": ["Python", "Data Science", "Web Development"],
"address": {
"street": "123 Tech Lane",
"city": "Boston",
"zipcode": "02101"
}
}你现在已经成功地学习了如何在 Python 中处理 JSON 数据，包括如何通过正确导入模块来避免 NameError: name 'json' is not defined 错误。
总结
在这个实验中，你已经学到了：
- Python 中的
NameError是什么，以及此异常的常见原因 - 如何识别和解决特定的错误
NameError: name 'json' is not defined - 使用不同的导入语法选项正确导入 JSON 模块的方法
- 如何在 Python 中处理 JSON 数据，包括：
- 将 Python 对象转换为 JSON 字符串
- 将 JSON 字符串解析为 Python 对象
- 将 JSON 数据写入文件
- 从文件中读取 JSON 数据
这些技能对于在 Python 中处理数据至关重要，尤其是在构建与 Web 服务通信或存储配置数据的应用程序时。通过了解如何正确导入和使用模块，你可以避免常见错误并编写更健壮的 Python 代码。
请记住，这种模式适用于所有 Python 模块，而不仅仅是 JSON 模块。在使用任何外部功能之前，请务必确保在文件开头有正确的导入语句。
