<think>在解决PyCharm中因不在同一个文件夹下而出现`from common import utils`导入错误的问题时，我们需要考虑Python的模块导入机制以及PyCharm的项目配置。以下是一步一步的解决方案： ### 1. **理解导入错误的原因** - Python导入模块时，会按照`sys.path`中的路径列表进行搜索。当尝试从一个不在当前目录或Python路径中的文件夹导入模块时，会出现`ModuleNotFoundError`。 - 在PyCharm中，项目根目录通常被自动添加到`sys.path`中。但如果`common`包不在根目录下，或者项目配置不正确，就会导致导入失败。 ### 2. **检查项目结构** 假设你的项目结构如下： ``` project_root/ │ ├── app/ # 你的应用目录 │ ├── main.py │ ├── common/ # 包含utils模块的包 │ ├── utils.py │ ├── __init__.py ``` 在`main.py`中，你尝试使用`from common import utils`，但此时`app`目录和`common`目录是同级目录，而`app`目录并不在Python路径中，因此无法直接导入`common`。 ### 3. **解决方案** #### 方法1：将项目根目录标记为Sources Root - 在PyCharm中，右键单击项目根目录（即包含`app`和`common`的目录），选择 **Mark Directory as** > **Sources Root**。 - 这样，PyCharm会将根目录添加到`sys.path`，使得可以从任何子目录中导入根目录下的包。 - **验证**：在`main.py`中，现在应该可以成功导入`from common import utils`。 #### 方法2：修改PYTHONPATH环境变量 - 如果你不想将整个根目录标记为Sources Root，可以手动添加路径到`PYTHONPATH`。 - 在PyCharm中，进入 **Run** > **Edit Configurations**，在对应的运行配置中，设置 **Environment variables**，添加： ``` PYTHONPATH=/path/to/project_root ``` - 或者在代码开头动态添加路径（不推荐，但临时有效）： ```python import sys sys.path.append('/path/to/project_root') ``` #### 方法3：使用相对导入（如果适用） - 如果`main.py`和`common`是同级目录，但由于`main.py`在`app`包内，则可以使用相对导入（前提是`app`也是一个Python包）： ```python from ..common import utils ``` - 注意：相对导入要求文件在包内运行（即不能作为主模块直接运行），否则会报错`ImportError: attempted relative import with no known parent package`。 #### 方法4：创建setup.py并安装项目（推荐用于复杂项目） - 在项目根目录创建`setup.py`，将项目安装为可编辑模式： ```python from setuptools import setup, find_packages setup( name='my_project', version='0.1', packages=find_packages(), ) ``` - 在终端中运行： ```bash pip install -e . ``` - 这样，你的项目包就可以像第三方包一样在任何位置被导入。 ### 4. **检查__init__.py文件** - 确保`common`目录下存在`__init__.py`文件（可以是空文件），以表明它是一个Python包。 ### 5. **重启PyCharm并重建索引** - 完成上述步骤后，重启PyCharm并选择 **File** > **Invalidate Caches / Restart** 来清除缓存并重建索引。 ### 6. **验证导入** - 在`main.py`中尝试导入，应该不再报错： ```python from common import utils ``` ### 总结 在PyCharm中解决导入错误的关键是确保包含被导入模块的目录位于Python路径中。最推荐的方法是**将项目根目录标记为Sources Root**，这样既方便又符合项目规范。如果项目结构复杂，可以考虑使用`setup.py`安装项目。 §§相关问题§§ 1. 如何在PyCharm中正确配置Python解释器路径？ 2. 相对导入和绝对导入在Python中有什么区别？ 3. 如何将本地项目打包为Python可安装包？ 4. 为什么在PyCharm中运行正常，但在终端运行却出现导入错误？ </think> ### 解决PyCharm中 "from common import utils" 导入错误 在PyCharm中遇到 `from common import utils` 导入错误通常是因为Python解释器无法定位`common`包的位置。以下是逐步解决方案： #### 1. **理解目录结构** 假设项目结构如下： ```bash project_root/ # 项目根目录 ├── app/ # 主应用目录（你的代码位置） │ └── main.py # 执行文件 └── common/ # 公共模块目录 ├── __init__.py └── utils.py # 要导入的模块 ``` 在`main.py`中使用`from common import utils`会报错，因为`common`不在`app`的同级路径。 #### 2. **解决方案** ##### 方法1：将项目根目录设为Sources Root（推荐） - **步骤**： 1. 在PyCharm中**右键单击项目根目录**（`project_root`） 2. 选择 **Mark Directory as → Sources Root** - **效果**： - PyCharm会将根目录加入`sys.path` - 可直接使用：`from common import utils` ##### 方法2：修改Python路径 - 在代码开头添加路径（临时方案）： ```python import sys sys.path.append("/path/to/project_root") # 替换为实际路径 from common import utils ``` ##### 方法3：配置运行参数 - **步骤**： 1. 打开 **Run → Edit Configurations** 2. 在 **Working directory** 中设置为项目根目录（`project_root`） - **效果**：执行时自动将根目录加入搜索路径。 ##### 方法4：创建虚拟环境（长期方案） ```bash # 在项目根目录创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows pip install -e . # 将项目安装为可编辑模式 ``` #### 3. **验证是否解决** 在`main.py`中测试： ```python from common import utils print(utils.some_function()) # 正常执行无报错 ``` #### 4. **关键检查点** - 确保`common`是有效Python包： - 包含 `__init__.py` 文件（可为空） - 避免命名冲突： - 检查是否有其他`common`包干扰（如已安装的第三方包） > **提示**：PyCharm标记为**Sources Root**后，目录图标会变成蓝色，表示已加入路径[^1]。