如何在 Python 脚本中动态指定模块导入路径（无需修改源码或环境变量）-Python教程-PHP中文网

如何在 Python 脚本中动态指定模块导入路径（无需修改源码或环境变量）

本文介绍如何在不改动现有 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

⚠️ 重要注意事项：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

不要使用 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，只要项目结构不变，导入均能稳定工作——完全符合“不改源码、不配环境变量、纯脚本内解决”的需求。