Python 解释器启动流程的完整解析

python解释器启动时不会默认自动执行任何.py文件；它从c语言main()函数开始初始化，仅在显式指定时才执行脚本或模块，site.py由解释器主动导入而非自动运行。

Python 解释器启动时最先执行哪个文件

没有“默认自动执行”的 Python 文件——python 命令本身不读任何 .py 脚本，除非你明确指定。所谓“启动流程”，本质是 CPython 解释器从 main() 函数开始，逐步初始化内存、导入内置模块、设置 sys.path，最后才决定是否执行代码。

常见误解是以为会自动运行 __init__.py 或 site.py，其实 site.py 是被显式导入的（由解释器在初始化后期调用 PyImport_ImportModule("site")），而 __init__.py 只在包导入时触发，跟启动无关。

• 直接运行 python（无参数）：进入交互模式，不执行任何用户文件
• 运行 python script.py：解析并执行 script.py，不经过 site.py 以外的“钩子”
• 运行 python -m module_name：等价于 import module_name，会走模块查找逻辑，可能触发 __main__.py
• PYTHONSTARTUP 环境变量指向的文件，只在交互模式下执行一次，不是所有启动路径都走这里

为什么修改 site-packages 下的 site.py 没生效

因为 site.py 是以 frozen module 形式内建在解释器二进制里的——你改了磁盘上的那个文件，CPython 启动时仍优先加载内置版本（通过 PyImport_FrozenModules）。只有当解释器编译时禁用了 --without-frozen-modules，才会 fallback 到磁盘路径。

验证方式很简单：python -c "import site; print(site.__file__)"。如果输出是类似 /path/to/python3.11/lib/site.py，说明走的是磁盘版；如果报错或显示 built-in，那就是冻结版。

立即学习“Python免费学习笔记（深入）”；

• 真正影响启动行为的，是解释器编译期配置和运行时环境变量（如 PYTHONNOUSERSITE、PYTHONDEVMODE）
• 想拦截模块导入？用 sys.meta_path 插入自定义 finder，比动 site.py 可靠得多
• 调试启动过程，加 -v 参数：它会打印每个 import 的来源，包括 site 是怎么被拉进来的

python -c 和直接写脚本的启动开销差多少

差别极小，但存在可测量的差异：python -c "print(1)" 比 python oneline.py 快约 5%–10%，主要省在文件 I/O 和 AST 解析阶段。两者共享同一套初始化流程（GC、heap setup、GIL 初始化、builtin module 加载），真正的分叉点在“代码源”——一个是字符串字面量，一个是磁盘文件。

不过这个差距只在毫秒级，对绝大多数场景无意义。容易被忽略的是：如果你在 -c 中拼接大量字符串（比如生成代码再 exec），反而会因 Python 字符串对象分配拖慢整体速度。

• -c 不支持多行缩进语法，换行需用分号或括号续行
• sys.argv[0] 在 -c 下固定为 -c，不是脚本名，会影响某些依赖 __file__ 的库
• 使用 python -i -c "x=1" 可进入交互模式并保留变量，适合快速测试片段

嵌入 Python 解释器（C API）时如何跳过 site 模块

嵌入场景下，默认不会自动导入 site，除非你显式调用 PyRun_SimpleString("import site") 或 PyImport_ImportModule("site")。这是和命令行解释器最根本的区别：嵌入时你完全掌控初始化节奏。

但要注意，即使跳过 site，sys.path 仍会被设为基本值（空列表 + 当前目录），很多标准库 import 会失败。所以“跳过 site”不等于“轻量启动”，只是移除了用户 site-packages 自动注入逻辑。

• 调用 Py_NoSiteFlag = 1（C 侧）或设置 PYTHONNOUSERSITE=1（环境变量）才能真正绕过 site 相关逻辑
• Py_SetPath() 必须在 Py_Initialize() 之前调用，否则无效；且传入的路径必须是绝对路径
• 嵌入时若未调用 PyEval_InitThreads()（旧版）或未正确管理 GIL（新版），多线程 import 可能崩溃，这比 site 问题更隐蔽

事情说清了就结束。启动流程里最易被当成“魔法”的部分，其实是那些隐式发生的 import——它们不报错、不打印、只默默改变 sys.modules，查问题时得靠 -v 或打 patch 看 C 层日志。