修改工作目录跨文件夹导入Python模块是否为不良实践？

一、切换目录导入模块属于不良实践吗？ #

是的，这种通过os.chdir()切换目录导入模块再切回原目录的做法属于典型的不良实践，主要问题在于：

• 路径依赖极强，可移植性差：脚本运行完全依赖当前工作目录，若在其他路径下执行（比如从project目录运行python new_experiment/main2.py，或把项目迁移到其他文件夹），切换目录的相对路径会直接失效，引发报错。
• 隐蔽bug高发：如果导入过程中出现异常，代码可能无法执行到切回原目录的语句，导致后续依赖原工作目录的操作全部失败；若多个脚本都用这种方式切换目录，还会互相干扰，引发难以排查的问题。
• 代码可读性与维护性差：其他开发者看到这段代码时，很难理解频繁切换目录的目的，增加了维护成本，也不符合Python的导入规范。
• 绕开标准导入机制：Python本身提供了完善的模块搜索路径管理机制，这种做法属于投机取巧，容易和标准机制产生冲突。

二、不修改原有目录结构的导入解决方案 #

针对你给出的文件夹结构，要在new_experiment/main2.py中导入experiment/utils/utils_functions.py且不修改experiment目录内容，推荐以下几种实用方法：

方法1：将项目根目录加入模块搜索路径 #

这是最简单直接的方式，适合数据分析场景下的短脚本复用需求，在main2.py开头添加以下代码：

import sys
from pathlib import Path

# 获取项目根目录（project文件夹）的绝对路径
project_root = Path(__file__).parent.parent
# 把根目录加入Python的模块搜索路径
sys.path.append(str(project_root))

# 现在可以直接按绝对路径导入工具函数
from experiment.utils.utils_functions import 你的函数名

这种方式通过Path(__file__)获取当前脚本的绝对路径，再推导到项目根目录，不管在哪个路径下运行main2.py都能正确找到模块，完全不依赖当前工作目录。

方法2：使用importlib动态导入模块 #

如果不想修改sys.path，可以直接指定模块文件的绝对路径动态导入，避免之前的相对导入报错：

import importlib.util
from pathlib import Path

# 拼接utils_functions.py的绝对路径
utils_file_path = Path(__file__).parent.parent / "experiment" / "utils" / "utils_functions.py"

# 创建模块规范并导入
spec = importlib.util.spec_from_file_location("utils_functions", utils_file_path)
utils_functions = importlib.util.module_from_spec(spec)
spec.loader.exec_module(utils_functions)

# 调用函数示例：utils_functions.你的函数名()

方法3：将项目安装为可编辑包（适合长期复用） #

如果你的工具函数会被多个实验脚本频繁复用，可以把整个项目安装成Python的可编辑包，这样在任何地方都能直接导入：

1. 在project目录下创建pyproject.toml文件，内容如下：

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

[project]
name = "my_experiment_project"
version = "0.1.0"
packages = ["experiment"]

2. 打开终端，进入project目录，执行命令：

pip install -e .

之后不管在哪个脚本里，都可以直接用from experiment.utils.utils_functions import ...导入，完全不用处理路径问题。

内容的提问来源于stack exchange，提问作者s-homberg