VSCode Python项目路径管理：实现灵活的文件相对路径访问

my_project/
├── main.py
└── src/
    ├── utils.py
    └── data/
        └── config.json

{
    "api_key": "your_secret_key_here",
    "timeout_seconds": 30,
    "environment": "development"
}

import os
import json

def load_config_relative_to_script():
    """
    加载位于当前脚本文件相对路径下的配置文件。
    例如，如果此脚本是 src/utils.py，
    而配置文件是 src/data/config.json，
    则路径会正确解析。
    """
    # 1. 获取当前脚本文件（utils.py）所在的目录的绝对路径
    #    例如：/path/to/my_project/src
    current_script_dir = os.path.dirname(os.path.abspath(__file__))

    # 2. 构建相对于当前脚本目录的完整路径
    #    os.path.join 会智能处理路径分隔符
    #    例如：/path/to/my_project/src/data/config.json
    config_file_path = os.path.join(current_script_dir, "data", "config.json")

    print(f"尝试从路径加载配置文件: {config_file_path}")
    try:
        with open(config_file_path, 'r', encoding='utf-8') as f:
            config_data = json.load(f)
            print("配置文件加载成功。")
            return config_data
    except FileNotFoundError:
        print(f"错误：未找到配置文件在 {config_file_path}")
        return None
    except json.JSONDecodeError:
        print(f"错误：配置文件 {config_file_path} 格式不正确。")
        return None
    except Exception as e:
        print(f"加载配置文件时发生未知错误: {e}")
        return None

if __name__ == "__main__":
    print("--- 从 src/utils.py 内部直接运行加载配置 ---")
    config = load_config_relative_to_script()
    if config:
        print(f"加载到的配置: {config}")

import sys
import os

# 确保项目根目录在 Python 路径中，以便正确导入 src 模块
# 在 VSCode 中，通常打开项目根目录作为工作区即可，或通过 launch.json 配置
# 这里为了演示，显式地将项目根目录添加到 sys.path
project_root = os.path.dirname(os.path.abspath(__file__))
if project_root not in sys.path:
    sys.path.insert(0, project_root)

from src.utils import load_config_relative_to_script

if __name__ == "__main__":
    print("\n--- 从 main.py 调用 src.utils.py 加