PyCharm取消源目录标记后，批量修复Python包导入语句的方法

在PyCharm中开发Python包my_package时，将my_package目录标记为源目录，IDE自动生成的导入语句如下：

from path1.to.module import something
from path2.to.another.module import more
import path3

[使用something和more的模块代码...]

其中path1、path2、path3均为my_package的直接子文件夹。打包发布并安装后，在Python Shell中执行导入时出现ModuleNotFoundError: No module named 'path1'错误——脱离PyCharm的源目录机制后，Python仅识别带包名前缀的合法导入方式：

from my_package.path1.to.module import something
from my_package.path2.to.another.module import more
from my_package import path3

[使用something和more的模块代码...]

由于涉及70多个文件，手动修改效率极低，需高效批量修复包内所有导入语句的方案。

方案一：IDE全局正则替换（推荐） #

利用PyCharm或其他IDE的全局正则替换功能，一步完成所有修改：

1. 打开全局替换工具（PyCharm快捷键：Ctrl+Shift+R，Mac为Cmd+Shift+R）。
2. 针对两种导入格式分别配置正则：
   • 匹配from pathX...格式：
     查找框输入：^from (path1|path2|path3)\.(.*) import (.*)
     替换框输入：from my_package.$1.$2 import $3
   • 匹配import pathX格式：
     查找框输入：^import (path1|path2|path3)$
     替换框输入：from my_package import $1
3. 选择替换范围为my_package整个目录，先通过「查找全部」预览修改内容，确认无误后点击「替换全部」。

提示：若子文件夹数量较多，可将正则中的(path1|path2|path3)替换为([a-zA-Z0-9_]+)（匹配合法Python模块名），但需确保这些子文件夹均为my_package的直接子模块，避免误替换。

方案二：Python脚本批量处理 #

编写脚本遍历所有.py文件，自动替换导入语句：

import os
import re

# 包根目录路径，根据实际情况修改
PACKAGE_DIR = "./my_package"
# 匹配目标导入语句的正则
from_regex = re.compile(r'^from (path1|path2|path3)\.(.*) import (.*)', re.MULTILINE)
import_regex = re.compile(r'^import (path1|path2|path3)$', re.MULTILINE)

for root, _, files in os.walk(PACKAGE_DIR):
    for file in files:
        if not file.endswith(".py"):
            continue
        file_path = os.path.join(root, file)
        
        with open(file_path, 'r', encoding='utf-8') as f:
            content = f.read()
        
        # 执行替换
        updated_content = from_regex.sub(r'from my_package.\1.\2 import \3', content)
        updated_content = import_regex.sub(r'from my_package import \1', updated_content)
        
        # 仅在内容变化时写入，避免无意义修改
        if updated_content != content:
            with open(file_path, 'w', encoding='utf-8') as f:
                f.write(updated_content)
            print(f"已更新: {file_path}")

运行前需将path1|path2|path3替换为实际子文件夹列表，或调整正则匹配所有合法模块名。

方案三：改用相对导入（可选） #

若不想添加包名前缀，可改用相对导入语法：

• 将from path1.to.module import something改为from .path1.to.module import something（适用于同层级模块引用）
• 跨层级引用时调整前缀数量，如from ..path1.to.module import something

这种方式无需依赖包名，仅适用于包内部模块间的引用。若包需要支持作为顶层模块直接导入，带包名的绝对导入更稳妥。

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