在 Python 同目录下调用模块或文件，本质上是利用 **模块搜索路径（sys.path）与包结构机制**，通过 `import`、相对导入或直接执行脚本的方式实现代码复用。**当两个 Python 文件位于同一目录时，最推荐的方式是使用标准的 `import 模块名` 语法，并确保目录结构符合包规范或运行入口正确。**如果出现“无法导入”错误，通常与执行路径、解释器工作目录或包初始化文件有关。理解 Python 的导入机制，是解决“同目录怎么调用”问题的关键。

---

## 一、理解 Python 同目录调用的基本原理

在讨论 Python 同目录调用之前，需要先理解 Python 的模块机制。Python 在执行 `import` 时，会按照 `sys.path` 中的路径顺序查找目标模块。默认情况下，**当前运行脚本所在目录会自动加入搜索路径的首位**，因此在同目录调用文件通常是可行的。

例如，当 `main.py` 和 `utils.py` 位于同一目录时，在 `main.py` 中使用：

```python
import utils
```

Python 会优先在当前目录中查找 `utils.py` 文件并加载为模块。此过程依赖 Python 的模块加载系统，这是语言级设计，并非额外配置功能。

根据 Python 官方文档（Python Docs, 2024），模块搜索顺序包括：当前目录、环境变量路径、标准库路径等。因此，**“同目录调用”实际上是 Python 默认支持的行为**，前提是执行方式正确。

---

## 二、最常见方式：使用 import 模块名

在 Python 同目录调用中，最推荐、最标准的做法是直接使用 `import 模块名`。这不仅语法清晰，而且符合 PEP 8 编码规范（Python Enhancement Proposal 8, 2023）。

假设目录结构如下：

```
project/
│
├── main.py
└── tools.py
```

在 `main.py` 中可以写：

```python
import tools

tools.say_hello()
```

在 `tools.py` 中：

```python
def say_hello():
    print("Hello from tools")
```

这种方式适用于简单项目或脚本开发。**优点是结构清晰、维护方便、可扩展性好**。缺点是如果文件名冲突（例如与标准库同名），可能会导致导入混淆。

在 Python 同目录调用实践中，建议避免使用与标准库同名的文件名，例如 `json.py`、`sys.py`，否则会覆盖系统模块。

---

## 三、from ... import ... 精准导入方式

除了 `import 模块名`，另一种常见的 Python 同目录调用方式是使用 `from 模块名 import 函数名`。这种方式可以提高代码可读性。

示例：

```python
from tools import say_hello

say_hello()
```

这种写法的优点是调用时不需要模块前缀，更简洁。缺点是**如果项目规模变大，可能会造成命名污染**。

下面是两种方式对比表：

| 对比维度 | import 模块名 | from 模块名 import 函数 |
|----------|---------------|--------------------------|
| 可读性 | 中等 | 高 |
| 命名冲突风险 | 低 | 较高 |
| 推荐指数 | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 适合场景 | 中大型项目 | 小型脚本 |

在 Python 同目录调用场景中，如果是工程项目，推荐使用第一种方式；如果是小工具或数据分析脚本，可以使用第二种方式。

---

## 四、同目录调用类（Class）文件

在 Python 同目录调用类文件时，原理与函数调用完全一致。假设：

```
project/
├── main.py
└── user.py
```

user.py：

```python
class User:
    def __init__(self, name):
        self.name = name
```

main.py：

```python
from user import User

u = User("Tom")
```

**本质上类在 Python 中也是对象，只要模块可导入，类即可实例化。**

在 Python 同目录调用类时要注意：

1. 文件名必须合法（不能以数字开头）
2. 不要与关键字冲突
3. 保证运行入口在正确目录

这类调用方式在 Web 后端开发、数据处理和自动化脚本中非常常见。

---

## 五、常见报错与解决方法

在 Python 同目录调用过程中，常见错误包括：

- ModuleNotFoundError
- ImportError
- attempted relative import

这些错误通常与运行方式有关，而不是代码本身错误。

例如：

```
python main.py
```

与

```
python -m project.main
```

行为不同。根据 Python 官方指南（Python Docs, 2024），当使用包结构时，应使用 `-m` 方式运行。

常见问题对比表：

| 报错类型 | 原因 | 解决方法 |
|-----------|-------|-----------|
| ModuleNotFoundError | 执行目录错误 | 切换到正确目录运行 |
| ImportError | 文件名冲突 | 修改文件名 |
| 相对导入错误 | 非包结构 | 添加 __init__.py |

在 Python 同目录调用中，80% 的问题来源于运行路径错误，而不是代码错误。

---

## 六、包结构下的同目录调用

当项目规模扩大时，Python 同目录调用通常会升级为包调用。

示例：

```
project/
├── app/
│   ├── __init__.py
│   ├── main.py
│   └── utils.py
```

此时推荐在 main.py 中使用：

```python
from . import utils
```

这种写法属于相对导入，只能在包结构中使用。

根据 PEP 328（Python.org, 2023），相对导入增强了模块可维护性，但必须在包上下文中执行。

**注意：直接运行含相对导入的文件会报错，必须使用模块方式执行。**

---

## 七、动态路径修改（不推荐但常见）

有些开发者会通过修改 `sys.path` 实现 Python 同目录调用，例如：

```python
import sys
sys.path.append('.')
```

这种方法可以临时解决路径问题，但**不推荐用于正式项目**。原因包括：

- 破坏模块搜索机制
- 降低代码可读性
- 难以维护

在企业级开发中，应通过合理的目录结构解决，而不是强行修改路径。

---

## 八、IDE 与命令行差异

在 Python 同目录调用时，IDE（如 VS Code、PyCharm）可能会自动设置运行路径，因此代码在 IDE 中正常，但在命令行报错。

这是因为 IDE 自动设置了工作目录（Working Directory）。

对比情况如下：

| 场景 | 是否自动设置路径 | 出错概率 |
|------|------------------|-----------|
| 命令行 | 否 | 中 |
| IDE | 是 | 低 |

因此，在开发 Python 同目录调用逻辑时，建议始终在命令行测试一次，以确保代码环境独立可运行。

---

## 九、最佳实践与未来趋势

综合来看，Python 同目录调用的最佳实践包括：

1. 使用标准 `import` 语法
2. 保持清晰目录结构
3. 避免文件名冲突
4. 大型项目采用包结构
5. 避免随意修改 sys.path

随着 Python 在数据科学、自动化和 Web 开发中的广泛应用，模块化和包结构设计将越来越重要。根据 Python 官方 2024 年发布的开发者趋势报告，**模块化代码组织能力已经成为衡量 Python 项目质量的重要标准**。

未来趋势将更加偏向：

- 标准化项目结构
- 使用虚拟环境管理依赖
- 避免路径硬编码

---

## 总结

Python 同目录调用本质是模块导入机制的体现。理解 `import` 工作原理、运行路径和包结构，基本可以解决所有“同目录怎么调用”的问题。对于简单脚本，直接 `import 模块名` 即可；对于工程项目，应构建标准包结构并通过模块方式运行。

随着项目规模扩大，合理设计目录结构将成为 Python 开发中的核心能力。掌握正确的调用方式，不仅能减少报错，还能显著提升代码的可维护性与扩展性。

---

参考与资料来源  
Python 官方文档. Modules — Python 3 Documentation, 2024. https://docs.python.org/3/tutorial/modules.html  
Python Enhancement Proposal 8 (PEP 8). Style Guide for Python Code, Python.org, 2023. https://peps.python.org/pep-0008/

确保两个Python文件在同一目录下，可以通过import语句直接导入另一个文件。例如，文件a.py中有函数foo，在b.py中使用import a，然后调用a.foo()即可访问函数。

使用import语句导入同目录文件

我有两个Python脚本文件放在同一个文件夹中，怎样才能在一个文件中调用另一个文件里的函数或变量？

如何在同一目录下导入另一个Python文件？

确认当前工作目录是两个文件所在目录，或者运行脚本时指定正确路径。可以使用sys.path.append('.')添加当前目录到模块搜索路径。此外，避免脚本文件名和标准库模块名重复，以防冲突。

检查运行环境和模块路径设置

我尝试导入同目录中的Python文件，但出现ModuleNotFoundError错误，如何解决？

调用同目录Python文件时遇到模块找不到该怎么办？

确保子文件夹内有__init__.py文件将其设置为包，在同目录的Python文件中使用相对路径导入，如from 子文件夹名 import 模块名，或者使用from .子文件夹名 import 模块名，前提是当前模块也在包内。

使用包和相对导入方式

如果想调用同目录下某个子文件夹中的Python文件，应该如何操作？

如何调用位于同目录子文件夹内的Python文件？

PingCodeDocs

Python同目录调用本质依赖模块搜索路径机制，通常使用import模块名即可完成调用，前提是运行目录正确且文件命名规范。常见报错多因执行路径或包结构不当引起。对于小型脚本可直接导入模块或函数，大型项目应采用标准包结构并使用模块方式运行，避免修改sys.path。掌握模块机制与目录设计，是解决同目录调用问题的关键。

python同目录怎么调用

用户关注问题