如何读取别的文件夹下的json数据

跨文件夹读取JSON数据：实用指南与代码示例**

在软件开发过程中，JSON（JavaScript Object Notation）因其轻量级、易读易写的特性，成为数据交换的主流格式之一，我们经常需要读取存储在项目不同文件夹下的JSON文件数据，本文将以Python为例，详细讲解如何跨文件夹读取JSON数据，并涵盖不同操作系统下的路径处理技巧,以及一些常见问题的解决方案。

核心思路：明确文件路径是关键

要读取“别的文件夹”下的JSON文件，最核心的问题在于如何准确、高效地指定该JSON文件的路径，一旦路径正确，后续的读取和解析操作就相对 straightforward 了。

在Python中,处理文件路径主要有两种方式：

1. 硬编码字符串路径：直接使用字符串表示路径，如 "C:/Users/Username/Documents/data.json" 或 "/var/www/html/config.json"，这种方式简单直接，但可移植性差,容易因操作系统或环境不同而出错。
2. 使用 os.path 模块或 pathlib 模块：这些模块提供了跨平台的路径操作方法，能更好地处理不同操作系统的路径分隔符（\ vs ），并方便路径的拼接和解析。强烈推荐使用这种方式。

准备工作：假设的文件结构

为了更好地说明,我们先假设一个简单的项目文件结构：

my_project/
│
├── main.py              # 我们的主程序
│
├── data/                # 存放JSON数据的文件夹
│   ├── users.json       # 我们要读取的JSON文件1
│   └── settings.json    # 我们要读取的JSON文件2
│
└── utils/               # 存放工具脚本的文件夹
    └── helper.py        # 可能也会用到JSON读取的脚本

我们的目标是在 main.py 中读取 data 文件夹下的 users.json 和 settings.json。

读取JSON数据的步骤（以Python为例）

读取JSON数据通常分为三步：

1. 导入必要的模块：主要是 json 模块用于解析JSON，以及 os 或 pathlib 模块用于路径处理。
2. 构建文件路径：准确指向目标JSON文件。
3. 打开文件并解析：使用 json.load() 或 json.loads() 读取并解析数据。

使用 os.path 模块（Python 3.5及之前版本常用）

os.path 模块提供了各种路径操作函数。

示例代码 (main.py)：

import os
import json
def read_json_from_another_folder(filename, subfolder='data'):
    """
    从指定子文件夹读取JSON文件
    :param filename: JSON文件名，如 'users.json'
    :param subfolder: 子文件夹名，默认为 'data'
    :return: 解析后的JSON数据（字典或列表）
    """
    try:
        # 1. 获取当前脚本所在目录的绝对路径
        current_dir = os.path.dirname(os.path.abspath(__file__))
        # 2. 构建目标JSON文件的完整路径
        #    os.path.join 会自动处理不同操作系统的路径分隔符
        file_path = os.path.join(current_dir, subfolder, filename)
        # 3. 打开文件并解析JSON数据
        with open(file_path, 'r', encoding='utf-8') as f:
            data = json.load(f)
        return data
    except FileNotFoundError:
        print(f"错误：文件未找到 - {file_path}")
        return None
    except json.JSONDecodeError:
        print(f"错误：JSON文件格式不正确 - {file_path}")
        return None
    except Exception as e:
        print(f"发生未知错误：{e}")
        return None
# --- 在main.py中使用 ---
if __name__ == "__main__":
    # 读取 data/users.json
    users_data = read_json_from_another_folder('users.json')
    if users_data:
        print("成功读取users.json:")
        print(users_data)
    print("\n" + "="*30 + "\n")
    # 读取 data/settings.json
    settings_data = read_json_from_another_folder('settings.json')
    if settings_data:
        print("成功读取settings.json:")
        print(settings_data)

代码解释：

• os.path.abspath(__file__)：获取当前脚本的绝对路径。
• os.path.dirname(...)：获取路径中的目录部分。
• os.path.join(...)：将多个路径组件智能地拼接成一个完整的路径,自动处理路径分隔符。
• with open(...) as f:：推荐使用 with 语句打开文件，它能确保文件在操作完成后自动关闭,即使发生异常。
• json.load(f)：从文件对象 f 中读取JSON数据并解析为Python对象（通常是字典或列表）。

使用 pathlib 模块（Python 3.4+，更现代和面向对象的方式）

pathlib 提供了面向对象的路径操作,更加直观和强大。

示例代码 (main.py)：

from pathlib import Path
import json
def read_json_with_pathlib(filename, subfolder='data'):
    """
    使用pathlib从指定子文件夹读取JSON文件
    :param filename: JSON文件名，如 'users.json'
    :param subfolder: 子文件夹名，默认为 'data'
    :return: 解析后的JSON数据（字典或列表）
    """
    try:
        # 1. 获取当前脚本所在目录的Path对象
        current_dir = Path(__file__).parent
        # 2. 构建目标JSON文件的完整Path对象
        #    / 操作符用于路径拼接
        file_path = current_dir / subfolder / filename
        # 3. 打开文件并解析JSON数据
        #    Path对象的read_text()方法可以直接读取文件内容
        data = json.loads(file_path.read_text(encoding='utf-8'))
        return data
    except FileNotFoundError:
        print(f"错误：文件未找到 - {file_path}")
        return None
    except json.JSONDecodeError:
        print(f"错误：JSON文件格式不正确 - {file_path}")
        return None
    except Exception as e:
        print(f"发生未知错误：{e}")
        return None
# --- 在main.py中使用 ---
if __name__ == "__main__":
    users_data = read_json_with_pathlib('users.json')
    if users_data:
        print("pathlib成功读取users.json:")
        print(users_data)
    print("\n" + "="*30 + "\n")
    settings_data = read_json_with_pathlib('settings.json')
    if settings_data:
        print("pathlib成功读取settings.json:")
        print(settings_data)

代码解释：

• Path(__file__)：将当前脚本路径字符串转换为Path对象。
• .parent：获取Path对象的父目录。
• Path对象重载了 运算符，用于路径拼接,非常方便。
• file_path.read_text(encoding='utf-8')：直接读取文件内容为字符串。
• json.loads(...)：从JSON字符串解析数据。

处理相对路径与绝对路径

• 相对路径：相对于当前工作目录（Current Working Directory, CWD），如果你直接运行 python main.py，CWD 通常是 my_project。data/users.json 这样的相对路径在 main.py 中是有效的，但如果 main.py 通过其他方式调用（例如IDE的运行配置可能将CWD设置在其他地方）,相对路径可能会失效。
• 绝对路径：从根目录开始的完整路径，优点是不受当前工作目录影响,缺点是可移植性差。

推荐做法：如上面示例所示，通过获取脚本自身所在目录，然后相对于脚本目录构建目标路径，这种方式最可靠，因为无论CWD如何变化,它都能正确找到相对于脚本位置的文件。

常见问题与注意事项

1. 文件路径不存在 (FileNotFoundError)：

   • 检查文件夹名称和文件名是否拼写正确。
   • 确认目标文件夹和文件确实存在。
   • 注意大小写敏感性（尤其是在Linux/macOS系统上）。

2. JSON解析错误 (json.JSONDecodeError)：

   • 检查JSON文件格式是否正确，例如引号是否成对，逗号是否多余,大括号是否匹配等。
   • 确保文件内容是有效的JSON，而不是其他格式（如CSV、XML）。

3. 编码问题：

   • 确保JSON文件是以UTF-8编码保存的（这是最常用的）。
   • 在 open() 函数中明确指定 encoding='utf-8',以避免在不同系统上出现默认编码不一致的问题。

4. 权限问题：

   确保运行脚本的用户对目标文件和文件夹有读取权限。