本文介绍如何在不改动现有 import 语句、不依赖命令行环境变量（如 pythonpath）、也不移动脚本位置的前提下，让 python 脚本从任意指定目录（如 other_scripts_folder）安全、可靠地导入模块。核心方法是通过操作 sys.path 并配合 importlib.util 或标准 import 机制实现运行时路径注入。
本文介绍如何在不改动现有 import 语句、不依赖命令行环境变量（如 pythonpath）、也不移动脚本位置的前提下，让 python 脚本从任意指定目录（如 other_scripts_folder）安全、可靠地导入模块。核心方法是通过操作 sys.path 并配合 importlib.util 或标准 import 机制实现运行时路径注入。
要在 my_script.py 中无缝导入位于同级目录 other_scripts_folder/ 及其子目录（如 other_scripts_folder/sub_folder/）下的 script1、script3 等模块，关键在于在 import 执行前，将目标根目录动态插入 sys.path[0]（最高优先级位置），而非仅追加到末尾。许多失败案例正是因为仅使用 sys.path.append()，导致相对导入或同名模块冲突时被其他路径的包覆盖。
以下是在 my_script.py 开头推荐的标准化写法：
import sys
import os
# 获取当前脚本所在目录（scripts_folder）
current_dir = os.path.dirname(os.path.abspath(__file__))
# 向上一级得到 project_folder，再拼接 other_scripts_folder
project_root = os.path.dirname(current_dir)
other_scripts_path = os.path.join(project_root, "other_scripts_folder")
# ✅ 关键：插入到 sys.path 开头，确保最高优先级加载
if other_scripts_path not in sys.path:
sys.path.insert(0, other_scripts_path)
# 现在可直接导入（假设 script1.py 在 other_scripts_folder 下）
import script1
from sub_folder import script3 # 自动识别子目录为包（无需 __init__.py，但建议添加以明确意图）
# 验证导入来源（调试用）
print(f"script1 loaded from: {script1.__file__}")⚠️ 重要注意事项：
- __init__.py 不是强制要求，但强烈推荐：若 other_scripts_folder 或其子目录（如 sub_folder）中缺少 __init__.py，Python 仍可导入 .py 文件（作为“命名空间包”），但部分 IDE 和类型检查器可能报错；添加空 __init__.py 可显式声明为常规包，提升兼容性与可维护性。
- 避免路径重复插入：使用 if ... not in sys.path 判断，防止多次运行时重复添加导致 sys.path 膨胀。
- 相对导入仍受限于执行上下文：本方案解决的是 绝对导入（import script1）和 包内相对导入（from .sub_folder import script3）——但若 script1.py 内部自身使用了 from .utils import helper 这类跨目录相对导入，则需确保其 __package__ 正确设置，此时建议改用 importlib.util.spec_from_file_location 动态加载单个文件（见进阶用法）。
- 不推荐 os.chdir()：修改工作目录会影响全局行为（如文件读写路径、日志输出等），且无法解决包层级感知问题，应避免。
✅ 总结：该方法完全在 Python 脚本内部完成，零外部依赖，适用于 Windows PowerShell、Linux Terminal 或任何支持 python my_script.py 的环境。它绕过了对项目结构重构、环境变量配置或 IDE 特定设置的需求，是生产环境中快速适配多目录模块依赖的稳健实践。
立即学习“Python免费学习笔记（深入）”；
