解决Python跨目录调用模块报No module named错误的正确方法

Alice
Alice
发布时间:2026-10-12| 3人浏览过
原创

本文详解Python在IDE与命令行环境下模块导入路径差异导致的No module named错误。通过对比pycharm与shell执行路径,提供将相对路径转为绝对路径加入sys.path的通用解决方案,确保代码在本地及Ubuntu服务器环境中灵活调用其他文件函数。

在编写Python程序时,开发者常习惯创建utils.py文件以集中存放常用函数,便于其他文件调用及通用函数的统一管理。此外,这也适用于处理不同文件间class或函数相互调用的场景。

参考如下工程目录结构:

工程目录

Project\
 ...
 src\
 main.py
 utils.py
 test.py
 ...

Python调用其他文件中的函数

在main.py文件中添加相应语句即可调用utils.py下的函数:

import src.utils as utils X, y = utils.load_data()

开发Python时通常使用IDE(如PyCharm、PyDev等),在这些环境中运行方便,可轻松切换解释器,右键文件运行即可,使用上述方法通常不会出现问题。

然而,当在本地编写代码后发现计算资源不足,转而使用Ubuntu服务器时,可能会遇到模块导入问题。

此时通过ssh admin@219.224.30.xxx登录服务器,选择个人工程目录,使用scp命令将本地代码拷贝过去,或通过git clone https://github.com/xxx将代码仓库克隆至服务器。随后cd Project/,执行python main.py,却报错No module named ‘src'。网上常见的解决方案是“在工程目录中加入sys”,

import sys sys.path.append('D:/pythonworkspace')

这种方法在本地确实能解决问题,但若更换其他盘符则需修改代码。在服务器上,D盘并不存在,因此仍需修改代码,缺乏灵活性。

原因分析

在文件中写入以下Python代码:

import sys print(sys.path)

分别使用PyCharm和Shell执行,发现两者的输出结果不同:

PyCharm输出:

D:\\pythonworkspace\\Project

Shell输出:

D:\\pythonworkspacr\\Projecrt\\src

有人可能认为,既然路径如此,只需cd ..然后执行python src/test.py即可,但实际仍会报错,提示找不到module。

这是因为PyCharm执行文件时路径是整个工程下的路径,而Shell执行文件时路径是执行文件所在的路径,并非Shell当前所在的文件路径。

解决方案

因此,正确的做法如下:

import sys sys.path.append("..")

先将相对路径转换为绝对路径,然后将该绝对路径加入系统变量中。这样即可在不同场景下使用Python命令,并灵活调用其他文件下的函数,避免报错。若包含多级目录,可继续添加sys.path.append("../..")。

以上关于解决Python调用自己文件函数/执行函数找不到包问题的内容分享完毕,希望能对大家有所帮助,也希望大家多多支持本站。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。