如何在指定路径的Python脚本中导入其他目录下的Python模块
跨目录导入db.py的实现方案
先明确两个目标路径的绝对定位,避免路径混淆:
- 待导入的db.py绝对路径:
/home/krishma/test/db/db.py- 编写导入逻辑的test.py绝对路径:
/user/scripts/test/test.py两个目录分属完全独立的文件路径,无上下级归属关系,需要通过调整Python模块搜索路径规则实现跨目录导入。
方法1:脚本内动态调整模块搜索路径(无需修改系统全局配置)
在test.py的最开头,将db.py所属的根目录/home/krishma/test插入Python的模块搜索列表sys.path,之后即可按照常规包结构导入db模块。
基础代码示例:
import sys import os # 将db.py所属的根目录加入Python模块搜索路径 db_project_root = "/home/krishma/test" sys.path.insert(0, db_project_root) # 按包结构导入db子目录下的db模块 from db import db
如果不想硬编码绝对路径,可通过当前test.py的运行位置动态拼接目标根目录路径,适配不同运行环境:
# 从当前脚本所在位置开始,根据实际目录层级动态定位目标根目录 current_script_dir = os.path.dirname(os.path.abspath(__file__)) db_project_root = os.path.abspath(os.path.join( current_script_dir, "../../../home/krishma/test" # 按照实际相对层级调整跳转层数 )) sys.path.insert(0, db_project_root) from db import db
注意:这里加入搜索路径的是/home/krishma/test根目录,不是db.py文件本身的路径,也不是/home/krishma/test/db子目录。如果直接将db子目录加入搜索路径,导入时需要写import db,这种写法容易和搜索路径中其他同名db模块产生冲突,优先使用包层级导入更稳妥。
方法2:通过PYTHONPATH环境变量持久化配置(脚本内无需额外写路径逻辑)
如果需要频繁运行test.py,可以直接把db项目的根目录加到全局Python模块搜索环境变量中,一劳永逸。
- 临时生效(仅当前终端会话有效):
执行命令export PYTHONPATH=/home/krishma/test:$PYTHONPATH后,直接运行test.py,Python会自动搜索到db包,脚本内可以直接写from db import db完成导入,不需要额外添加sys.path操作代码。 - 永久生效:将上面的export语句添加到用户目录下的
.bashrc、.zshrc等shell配置文件中,保存后执行source ~/.bashrc即可永久生效。
常见注意事项
- 低版本Python适配:Python 3.3以下版本需要在
/home/krishma/test和/home/krishma/test/db目录下创建空的__init__.py文件,标记目录为可导入的Python包;Python 3.3+版本支持命名空间包,无该文件也可正常导入。 - 导入优先级控制:使用
sys.path.insert(0, 目标路径)是将自定义路径放到搜索列表的最前端,避免被其他同名模块的搜索结果覆盖。
内容的提问来源于stack exchange,提问作者krishma_thakral
相关产品推荐
相关产品推荐

