调试Python包__main__.py时如何让__init__.py执行？

问题描述 #

• 在命令行执行python -m some_package时，some_package/__init__.py（包含print("hello __init__.py")）和some_package/__main__.py（包含print("hello __main__.py")）的代码都会执行并打印内容。
• 但在VSCode中调试__main__.py时，仅__main__.py运行，破坏非简单场景下的程序行为；若调试__init__.py，则__main__.py始终不会执行，该如何解决？

补充疑问 #

1. 发现从其他脚本导入some_package时，仅__init__.py会执行。是否需要在__init__.py中添加关键语句，并从该文件启动调试？
2. 查阅《Python Packages》官方文档后，开始质疑__main__.py的存在意义？

解决方案与解释 #

一、VSCode调试匹配命令行python -m行为的方法 #

想让VSCode调试时和命令行python -m some_package的执行效果完全一致，不用改代码，调一下调试配置就行：

1. 打开VSCode的「运行和调试」面板，新建或修改launch.json配置文件
2. 加入下面的配置：

{
    "name": "Python: 模块模式启动",
    "type": "python",
    "request": "launch",
    "module": "some_package",
    "console": "integratedTerminal"
}

• 这个配置会让VSCode以模块模式启动调试，完全复刻python -m some_package的执行流程：先加载__init__.py完成包初始化，再执行__main__.py的逻辑
• 启动调试时选这个配置，就能同时触发两个文件的执行，和命令行跑的效果一模一样

二、关于__init__.py启动调试的疑问 #

不需要在__init__.py中额外加语句来启动调试。__init__.py的核心作用是初始化包环境——比如定义要导出的变量、导入子模块、配置全局参数等，它是包被导入时自动执行的初始化入口，不是程序运行的启动入口。要是强行在__init__.py里加启动逻辑，会导致每次导入这个包都触发执行，完全不符合Python包的设计规范。

三、__main__.py的存在意义 #

__main__.py就是给Python包留的「直接运行入口」，核心作用是区分两种使用场景：

• 当包被其他脚本导入时：只执行__init__.py做初始化，不会触发业务逻辑，保证包的复用性
• 当用python -m some_package直接运行包时：在完成__init__.py的初始化后，执行__main__.py里的代码，让包能像独立脚本一样跑起来

举个实际例子：比如你写了一个数据处理包，其他脚本导入它时只需要调用里面的工具函数；而直接运行这个包时，你可以在__main__.py里写完整的数据拉取、清洗、导出流程，一键执行。这样既让包能被灵活复用，又具备独立运行的能力，完全契合Python模块化的设计思路。

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