PyCharm venv运行项目报No module named 'Weapons'控制台可导入

• 运行项目代码时抛出异常：ModuleNotFoundError: No module named 'Weapons'
• 自定义编写的Python包，在PyCharm创建的venv虚拟环境中运行项目时无法被Python识别
• PyCharm内置Python控制台可以正常导入该包，但控制台的导入路径配置不会在项目正式运行时自动生效

1. 先核对运行配置和解释器一致性 #

• 点击PyCharm右上角运行配置的下拉菜单，选择「Edit Configurations」，确认当前运行脚本绑定的Python解释器路径，和控制台左下角显示的解释器路径完全匹配。最常见的低级错误就是控制台绑定了目标venv解释器，但运行配置误选了全局Python或者其他虚拟环境的解释器，环境不一致自然找不到包。
• 同页面确认「Working directory」（工作目录）配置为项目根目录，也就是Weapons包所在的父级目录，不要误选到项目下的子文件夹。

2. 修复Python模块搜索路径缺失问题 #

PyCharm的Python控制台默认会自动把项目源码根目录加入sys.path搜索列表，但直接运行脚本时不会自动添加这个路径，这是控制台能导入、运行就报错的核心诱因。

• 临时验证方案：在报错脚本的最顶部、导入Weapons的代码之前，加入以下代码验证：

import sys
# 将路径替换为你本地项目根目录的绝对路径，即Weapons文件夹的上级目录路径
sys.path.append("替换为你的项目根目录绝对路径")

加完运行如果导入正常，就能100%确认是搜索路径缺失的问题。

• 永久无代码修复方案：在PyCharm项目文件树里，右键点击Weapons包所在的项目根目录文件夹，选择菜单里的「Mark Directory as」→「Sources Root」，标记后PyCharm运行项目时会自动把该目录加入模块搜索路径，不需要额外修改代码。

3. 把自定义包装入venv环境（跨项目/跨运行方式通用方案） #

如果不想依赖PyCharm的路径配置，想让这个venv环境下所有运行场景都能识别Weapons包：

• 激活当前项目使用的venv虚拟环境
• 进入Weapons包的上级目录，如果还没写打包配置，就新建一个最基础的pyproject.toml或者setup.py文件
• 执行命令pip install -e . 用可编辑模式安装自定义包，安装完成后只要使用该venv的解释器，不管工作目录在哪、是不是在PyCharm里运行，都能正常导入Weapons包。

4. 排查包本身的结构错误 #

• 确认Weapons文件夹内存在__init__.py文件，哪怕是空文件也可以，Python需要这个文件来识别文件夹为可导入的合法包。
• 排查项目目录下是否存在命名为Weapons.py的同名脚本，或者其他和Weapons重名的模块，命名冲突会导致Python优先加载错误的文件，抛出找不到模块的异常。

内容的提问来源于stack exchange，提问作者Денис Буковский