### Python 初学者实现 JSON 文件输出时可能遇到的问题及解决方法 #### 1. **JSON 序列化失败** - **问题描述**: 如果尝试将不可序列化的对象（如自定义类实例）写入 JSON 文件，会抛出 `TypeError`。 - **解决方法**: 可以通过重载 `default` 参数来自定义序列化逻辑。例如，在函数中返回该对象的可序列化表示形式[^2]。 ```python import json class Person: def __init__(self, name, age): self.name = name self.age = age person = Person("Alice", 30) def custom_serializer(obj): if isinstance(obj, Person): return {"name": obj.name, "age": obj.age} raise TypeError(f"Type {type(obj)} not serializable") with open('output.json', 'w') as f: json.dump(person, f, default=custom_serializer) ``` --- #### 2. **编码格式问题** - **问题描述**: 默认情况下，`json.dump` 和 `json.dumps` 方法使用 ASCII 编码，特殊字符会被转义，影响可读性。 - **解决方法**: 设置参数 `ensure_ascii=False` 并指定合适的编码格式（通常是 UTF-8）。这样可以保留原始字符而不被转义[^2]。 ```python data = {"greeting": "你好"} with open('output.json', 'w', encoding='utf-8') as f: json.dump(data, f, ensure_ascii=False, indent=4) ``` --- #### 3. **文件路径错误** - **问题描述**: 新手容易忽略相对路径和绝对路径的区别，导致无法找到生成的 JSON 文件。 - **解决方法**: 使用标准库中的 `os.path` 或 `pathlib` 模块来构建可靠的文件路径[^2]。 ```python from pathlib import Path file_path = Path.cwd() / "output.json" with file_path.open('w', encoding='utf-8') as f: json.dump({"key": "value"}, f, ensure_ascii=False, indent=4) ``` --- ### 字典操作相关问题及解决方法 #### 1. **键值缺失处理** - **问题描述**: 访问字典中不存在的键时会触发 `KeyError`。 - **解决方法**: 使用 `.get()` 方法提供默认值，或者借助 `collections.defaultdict` 自动生成缺省项[^3]。 ```python my_dict = {} print(my_dict.get("missing_key", "Default Value")) # 输出 Default Value from collections import defaultdict dd = defaultdict(int) print(dd["non_existent"]) # 输出 0 ``` --- #### 2. **动态更新复杂嵌套字典** - **问题描述**: 对于深层嵌套的字典结构，手动逐层创建子节点较为繁琐。 - **解决方法**: 定义递归辅助函数简化操作流程[^3]。 ```python def set_nested_value(d, keys, value): if len(keys) == 1: d[keys[0]] = value return key = keys[0] if key not in d or type(d[key]) is not dict: d[key] = {} set_nested_value(d[key], keys[1:], value) nested_dict = {} set_nested_value(nested_dict, ["a", "b", "c"], 42) print(nested_dict) # {'a': {'b': {'c': 42}}} ``` --- ### 递归相关问题及解决方法 #### 1. **最大递归深度超出限制** - **问题描述**: 复杂递归调用可能导致栈溢出，报错 `RecursionError: maximum recursion depth exceeded`。 - **解决方法**: 修改解释器的最大递归层数（谨慎调整），或优化算法减少不必要的递归层次。 ```python import sys sys.setrecursionlimit(3000) # 扩展递归深度至 3000 层 ``` --- #### 2. **缺乏清晰的基线条件** - **问题描述**: 若递归函数缺少明确的终止条件，则会造成无限循环。 - **解决方法**: 确保每种输入情况都能匹配到至少一个退出分支[^3]。 ```python def factorial(n): if n == 0: # 基线条件 return 1 return n * factorial(n - 1) print(factorial(5)) # 输出 120 ``` --- ### 函数使用相关问题及解决方法 #### 1. **作用域混乱** - **问题描述**: 在函数内部修改全局变量时未声明 `global` 关键字，导致 UnboundLocalError 错误。 - **解决方法**: 明确区分局部与全局变量的作用范围，并遵循最小权限原则设计代码。 ```python counter = 0 def increment(): global counter # 声明引用的是外部全局变量 counter += 1 increment() print(counter) # 输出 1 ``` --- #### 2. **默认参数陷阱** - **问题描述**: 默认参数为可变类型（如列表或字典）时，多次调用间共享同一内存地址。 - **解决方法**: 将默认值设为空值并在函数体内初始化副本。 ```python def append_to_list(value, my_list=None): if my_list is None: my_list = [] my_list.append(value) return my_list print(append_to_list(1)) # [1] print(append_to_list(2)) # [2] ``` --- ### 总结知识点 1. **JSON 操作核心概念** 掌握如何使用 `json.load/dump` 和 `json.loads/dumps` 方法完成数据加载/保存任务，理解序列化与反序列化的含义。 2. **字典高级特性** 学习灵活运用 `.get()`、`.update()`、`defaultdict` 等工具提升效率；熟悉嵌套字典的操作模式。 3. **递归思维训练** 构建清晰的递归模型需注重边界条件的设计，同时注意性能瓶颈所在[^3]。 4. **函数封装最佳实践** 合理分配职责给不同函数单元，保持单一责任原则；警惕隐含副作用带来的风险。 ---