Python主目录含连字符时跨文件夹导入模块报错排查

• 方法1问题：sys.path 仅接收目录作为搜索路径，传入/C:/bi-etl/utils/file_a.py这类单文件路径时，Python不会在该位置搜索模块；另外Windows下C盘路径写法错误，多了前置斜杠，正确盘符路径开头为C:/而非/C:/。
• 方法2问题：Python标识符（模块名、包名）不允许包含中划线-，bi-etl中的横杠会被解析为减号运算符，直接触发语法错误。

方案1：路径动态注入（无需调整项目结构，改造成本最低） #

在导入自定义模块前，将bi-etl项目根目录注入Python模块搜索路径即可，推荐用相对路径写法，避免硬编码本地盘符导致的兼容性问题。
parameter_update.py 代码示例：

import sys
from pathlib import Path

# 当前文件位于 bi-etl/googlesheet/parameter_update.py
# 向上取两级父目录即为bi-etl项目根目录
project_root = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(project_root))

# 完成路径注入后即可正常导入utils下的模块
from utils.file_a import logger, report
from utils.file_b import get_env, get_path

# 原有第三方库导入
import pandas as pd
import json
import requests
import urllib.parse as urlparse
from datetime import datetime

提示：该写法不依赖项目本地存放位置，迁移到其他设备、其他盘符不需要修改路径代码。

方案2：包化管理（适合长期维护的正式项目） #

如果项目后续会持续扩展、存在多目录交叉导入需求，推荐按Python包规范调整结构：

1. 将项目名从bi-etl修改为bi_etl，移除包名中的中划线，符合Python标识符命名规则。
2. 在bi_etl、utils、googlesheet三个目录下分别创建空的__init__.py文件，标记目录为Python包，调整后结构如下：

├───bi_etl
│   ├───__init__.py
│   ├───utils
│   │   ├───__init__.py
│   │   ├───file_a.py
│   │   └───file_b.py
│   ├───googlesheet
│   │   ├───__init__.py
│   │   ├───parameter_update.py

3. 在bi_etl的上级目录执行以下命令，以开发模式将项目注册到当前Python环境：

pip install -e .

4. 注册完成后，项目下任意位置的脚本都可以直接通过绝对包路径导入模块，不需要额外处理sys.path：

from bi_etl.utils.file_a import logger, report
from bi_etl.utils.file_b import get_env, get_path

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