PyCharm调试终端启动的Python包时断点失效原因及解决方法

1. 子进程脱离调试器上下文：os.system()会启动完全独立的子进程运行module_name，而PyCharm调试器仅附着在主进程上，无法追踪子进程的执行流程，因此断点被直接忽略。
2. 终端调用未关联调试器：直接在终端执行module_name时，启动的是全新的Python进程，没有和PyCharm调试器建立连接，断点自然无法触发。

方案1：直接在PyCharm中配置入口脚本调试 #

• 定位module_name的入口脚本：
  • Linux/macOS终端执行which module_name，Windows执行where module_name，可获取脚本路径；
  • 也可查看包结构，入口脚本通常在bin目录或包的__main__.py文件中。
• 添加PyCharm运行配置：
  • 点击Run -> Edit Configurations -> 点击+选择Python；
  • Script path填入找到的入口脚本路径；
  • Parameters填入--additional_args等命令行参数；
  • 确认配置使用的解释器是安装module_name的虚拟环境/全局解释器；
  • 启动调试，断点即可正常触发。

方案2：替换os.system为带调试附着的subprocess #

若必须在现有脚本中调用module_name，用subprocess替代os.system并附加调试器参数：

import subprocess
import sys

# 配置PyCharm调试器参数（默认端口5678，可在Attach配置中查看）
debug_params = [
    sys.executable,
    "-m", "pydevd",
    "--multiprocess",
    "--client", "localhost",
    "--port", "5678"
]

# 组合原命令与调试参数
cmd = debug_params + ["module_name", "--additional_args"]
subprocess.run(cmd)

• 先在PyCharm中开启Run -> Attach to Process，确保调试器处于监听状态；
• 运行主脚本，子进程会自动连接调试器，触发entry_func()处的断点。

方案3：终端调用时手动附着调试器 #

• 在PyCharm中打开Run -> Attach to Process，记录默认监听端口（一般为5678）；
• 终端执行以下命令启动module_name，强制连接到PyCharm调试器：

python -m pydevd --multiprocess --client localhost --port 5678 -m module_name --additional_args

• 此时终端启动的进程会关联调试器，断点即可生效。

• 确保PyCharm中打开的源代码是你实际安装的module_name版本（检查项目解释器是否指向正确环境）；
• 若通过pip install -e安装可编辑包，直接调试项目内源代码即可；否则需找到安装目录下的module_name.py文件，打开后再设置断点。

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