Python跨文件夹导入函数失败求助：VSCode可用PyCharm报错

问题背景 #

项目目录结构如下：

Project:
  -dbNameFolder
     + __init__.py
     + dbNames.py
  -FolderIwantToImportTo
     + file.py 

dbNames.py中定义了如下函数：

def Add(a,b):
   return (a+b)

尝试使用from solve.basic import Add导入时提示函数未找到，使用sys模块添加路径的方法仅在VSCode中有效，PyCharm仍报错。

可行解决方案 #

方法1：将项目根目录标记为源码根（IDE适配） #

这是最简洁的方式，让IDE自动识别导入路径：

• PyCharm：右键Project文件夹 → 选择Mark Directory as → Sources Root
• VSCode：直接打开Project文件夹作为工作区，VSCode会自动将其视为源码根目录

完成后，在file.py中使用正确的导入语句：

from dbNameFolder.dbNames import Add

如果想简化导入路径，可以修改dbNameFolder/__init__.py，添加以下内容：

from .dbNames import Add

之后在file.py中就能直接写：

from dbNameFolder import Add

方法2：动态添加项目根目录到Python路径（通用所有环境） #

如果需要在不同IDE或环境下都能正常运行，可在file.py开头添加以下代码，动态获取并添加项目根目录到sys.path：

import os
import sys

# 获取当前文件所在文件夹路径
current_folder = os.path.dirname(os.path.abspath(__file__))
# 向上遍历得到项目根目录（Project文件夹）
project_root = os.path.dirname(current_folder)
# 将项目根目录加入Python搜索路径
if project_root not in sys.path:
    sys.path.append(project_root)

# 执行导入
from dbNameFolder.dbNames import Add

问题原因说明 #

• 你之前使用的from solve.basic import Add导入路径与实际项目结构完全不符，导致无法找到目标函数
• 若之前的sys方法仅在VSCode有效，大概率是因为路径写死（比如使用绝对路径），动态获取项目根目录的方式可以避免环境差异导致的路径问题

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