如何在PyCharm调试模式下运行`python -m`指定的模块脚本

要解决PyCharm调试时的相对导入问题，核心是让PyCharm以模块模式运行脚本，而非直接执行脚本文件，具体步骤如下：

1. 打开运行/调试配置窗口

   • 点击PyCharm右上角的运行配置下拉框，选择「Edit Configurations...」；或通过顶部菜单栏「Run」→「Edit Configurations...」进入

2. 创建新的Python配置

   • 点击配置窗口左上角的「+」按钮，选择「Python」类型

3. 配置模块运行参数

   • 在「Configuration」标签页中，勾选「Run as module」选项（默认是「Run as script」）
   • 在「Module name」输入框中，填写你在命令行python -m后使用的模块路径，比如path.to.my_script（注意不要加.py后缀）
   • 确认「Working directory」设置为你的项目根目录（也就是你平时执行python -m命令时所在的目录，这是相对导入能找到父包的关键）

4. 保存并启动调试

   • 点击「Apply」保存配置，再点击「OK」关闭窗口
   • 选择刚才创建的配置，点击调试按钮（虫子图标）即可启动调试

额外注意事项 #

• 确保项目根目录已被PyCharm标记为「Sources Root」：右键根目录→「Mark Directory as」→「Sources Root」，这样PyCharm才能正确识别包结构
• 若模块路径提示找不到，检查包目录下是否有__init__.py文件（Python 3.3+支持无此文件的命名空间包，但添加后兼容性更好）

内容的提问来源于stack exchange，提问作者Boschie