在 Python 编程中，JSON（JavaScript Object Notation）是一种常用的轻量级数据交换格式。我们经常需要从本地文件中读取 JSON 数据并进行处理。本文将以一个简单的读取 JSON 文件的代码示例为起点，逐步进行优化，同时深入探讨一些常见的陷阱和改进方法。
1. 初始代码：简单的 JSON 文件读取
以下是最基础的读取本地 JSON 文件的代码示例：
import jsonglobal data;if __name__ == '__main__': with open('account.json', 'r', encoding='utf-8') as file: data = json.load(file) print(data)这段代码能够正常读取本地名为 account.json 的 JSON 文件，并将其内容打印出来。然而，代码中有一些可以优化的地方，尤其是在变量作用域和代码可扩展性方面。
2. 分析与优化方向
global 的使用：代码中的 global 关键字用来声明全局变量，通常用于在函数内部修改全局变量的值。但在此代码中，data 变量是在主作用域中定义并使用的，global 其实是多余的。去掉 global 不会影响代码的正常运行，并且使代码更简洁。
异常处理：当前的代码假设文件始终存在且格式正确，但在真实环境中，可能会出现文件路径错误、文件不存在或 JSON 格式不正确的情况。如果不处理这些情况，程序会直接崩溃并抛出错误。因此，引入异常处理机制是非常重要的改进。
函数封装：为了使代码具有更好的可维护性和复用性，建议将读取 JSON 文件的逻辑封装成一个函数。这样不仅提高了代码的清晰度，还便于以后调用。
3. 代码优化步骤
我们从去掉多余的 global 关键字开始，然后逐步进行代码优化。
去掉 global 关键字
在 Python 中，global 通常用于函数内部来修改全局变量。在当前场景下，data 是在主函数中定义的，因此是全局变量，根本不需要显式使用 global。去掉 global 后，代码更清晰：
import jsonif __name__ == '__main__': with open('account.json', 'r', encoding='utf-8') as file: data = json.load(file) print(data)增加异常处理
为了让代码更加健壮，我们需要考虑以下几个场景：
文件不存在。JSON 文件格式不正确。可以通过 try-except 语句来捕获这些异常，并在发生错误时给出用户友好的提示：
import jsonif __name__ == '__main__': try: with open('account.json', 'r', encoding='utf-8') as file: data = json.load(file) print(data) except FileNotFoundError: print("文件未找到，请检查文件路径") except json.JSONDecodeError: print("文件格式错误，请检查是否为有效的 JSON 格式")函数封装
为了提高代码的模块化和可复用性，我们将文件读取的逻辑封装到一个函数中。这样，当你在其他地方需要读取 JSON 文件时，直接调用这个函数即可，避免代码重复：
import jsondef load_json_file(file_path): """读取 JSON 文件并返回解析后的数据""" try: with open(file_path, 'r', encoding='utf-8') as file: return json.load(file) except FileNotFoundError: print(f"文件 '{file_path}' 未找到") except json.JSONDecodeError: print(f"文件 '{file_path}' 格式错误") return Noneif __name__ == '__main__': data = load_json_file('account.json') if data: print(data)4. 代码解释
函数 load_json_file()：此函数接受一个文件路径作为参数，负责读取并解析 JSON 文件。它不仅提高了代码的可读性和扩展性，还便于错误处理。
异常处理：我们使用 FileNotFoundError 来处理文件不存在的情况，使用 json.JSONDecodeError 处理文件内容格式不正确的情况。这些异常处理有助于提高代码的健壮性，避免因文件问题导致的程序崩溃。
if data:：在读取文件时，返回的 data 可能是 None（在文件读取失败的情况下）。因此，我们需要检查数据是否成功读取，只有成功时才输出内容。
5. 小结
通过一系列的优化步骤，我们使得代码从最初的简单读取 JSON 文件，变得更具容错性和扩展性。这些改进包括去掉不必要的 global 关键字、增加异常处理以及通过函数封装提高代码的可维护性。
最终优化后的代码更具通用性，可以处理各种潜在的异常，同时结构更加清晰、简洁。无论是初学者还是有经验的开发者，都可以从这篇文章中学到如何编写更健壮的 Python 代码。
扩展阅读：
Python 文档：json 模块Python 异常处理：try-except 机制