为何Discord Bot子模块可跨目录导入config.py？新项目失效

原因分析 #

旧项目能成功导入的核心是Python的模块搜索路径（sys.path）中包含了项目根目录，常见触发场景：

• 你一直是在根目录下直接执行python bot.py启动Bot：此时Python会自动把当前工作目录（项目根目录）添加到sys.path首位，子目录模块自然能找到同级的config.py。
• 旧项目曾以可编辑模式安装（比如执行过pip install -e .）：这会把项目根目录加入Python的全局site-packages搜索路径，无论从哪里启动都能定位到模块。

新项目失效大概率是启动方式改变——比如在子目录下执行脚本，或者启动时的当前工作目录不是项目根目录，导致根目录没被加入sys.path，因此找不到config.py。

正确实现方式 #

方法1：使用相对导入（规范写法） #

修改cl/class_gift_manager.py的导入语句，用相对路径指向父目录的config：

from ..config import GIFT_HOURS, GIFT_PRICES, GIFT_EXPS

class GiftManager:
    def __init__(self) -> None:
        self.gift_hours = GIFT_HOURS
        self.gift_prices = GIFT_PRICES
        self.gift_exps = GIFT_EXPS

注意：这种写法要求将项目作为包启动，比如在根目录下执行python -m bot，或在根目录的上级目录执行python -m root.bot。

方法2：手动添加根目录到sys.path（兼容应急写法） #

如果不想大规模修改代码，可以在子模块开头手动注入根目录路径：

import sys
from pathlib import Path

# 获取项目根目录（当前文件的父目录的父目录）
root_dir = Path(__file__).parent.parent
sys.path.append(str(root_dir))

from config import GIFT_HOURS, GIFT_PRICES, GIFT_EXPS

class GiftManager:
    def __init__(self) -> None:
        self.gift_hours = GIFT_HOURS
        self.gift_prices = GIFT_PRICES
        self.gift_exps = GIFT_EXPS

这种写法不依赖启动工作目录，兼容性强，但属于补丁式写法，不如规范包导入优雅。

方法3：将项目作为可编辑包安装（长期推荐） #

在项目根目录创建pyproject.toml声明为Python包，执行pip install -e .将其加入全局搜索路径，之后子模块可直接import config。

示例pyproject.toml内容：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "your-discord-bot"
version = "0.1.0"

总结 #

旧项目的“异常”成功是依赖Python自动添加的工作目录路径，属于非规范写法；新项目失效是因为启动环境的sys.path未包含根目录。推荐用相对导入或可编辑包安装的方式，让导入逻辑更稳定、符合Python模块规范。

内容的提问来源于stack exchange，提问作者xxSithRagexx