本文介绍如何在不改动现有 import 语句、不依赖命令行环境变量（如 PYTHONPATH）的前提下，让 Python 脚本从任意指定目录（如 other_scripts_folder）安全、可靠地导入模块。核心方法是通过操作 sys.path 并确保路径有效性。
本文介绍如何在不改动现有 import 语句、不依赖命令行环境变量（如 pythonpath）的前提下，让 python 脚本从任意指定目录（如 `other_scripts_folder`）安全、可靠地导入模块。核心方法是通过操作 `sys.path` 并确保路径有效性。
要在 my_script.py 中无缝导入位于 other_scripts_folder（及其子目录 sub_folder）下的 script1、script2、script3 等模块，关键在于将目标目录提前插入 sys.path 的最前端，并确保该路径是绝对路径且真实存在——这是避免相对导入失效和 ModuleNotFoundError 的根本前提。
以下是在 my_script.py 开头推荐的标准化写法：
import sys
import os
# ✅ 正确：基于当前脚本位置，向上追溯并定位 other_scripts_folder
current_dir = os.path.dirname(os.path.abspath(__file__))
project_root = os.path.dirname(current_dir) # project_folder
other_scripts_path = os.path.join(project_root, "other_scripts_folder")
# 验证路径存在且为目录（防御性编程）
if not os.path.isdir(other_scripts_path):
raise RuntimeError(f"Import source directory not found: {other_scripts_path}")
# ⚠️ 关键：插入到 sys.path[0]，优先级最高，覆盖同名模块
if other_scripts_path not in sys.path:
sys.path.insert(0, other_scripts_path)
# 现在可直接导入（无需修改 script1/script3 等内部的相对 import！）
import script1
from sub_folder import script3⚠️ 重要注意事项：
- 不要使用 os.chdir() 切换工作目录——这会破坏脚本内所有相对路径（如文件读写、配置加载）的语义；
- 避免仅用 sys.path.append(...)：若存在同名模块（如标准库或已安装包），append 会将其置于搜索链末端，导致导入失败或误导入；
- sub_folder 下的模块需满足 Python 包结构要求：其目录中必须包含 __init__.py（可为空文件），否则无法被识别为包；
- 若 other_scripts_folder 中模块本身也含跨子目录的相对导入（如 from .sub_folder import script4），则需确保整个 other_scripts_folder 是一个顶层包（即其父目录 project_folder 应在 sys.path 中），但本方案中我们已将其设为 sys.path[0]，故天然支持。
✅ 最终效果：你在 PowerShell 或 CMD 中无论从哪个路径执行 python scripts_folder/my_script.py，只要项目结构不变，导入均能稳定工作——完全符合“不改源码、不配环境变量、纯脚本内解决”的需求。
立即学习“Python免费学习笔记（深入）”；
