py_compile.compile() 用于将 .py 源文件编译为 .pyc 字节码文件，默认存入 __pycache__ 目录；必须传入绝对路径，成功返回 .pyc 路径，失败默认返回 None（可设 doraise=True 抛异常）。
py_compile.compile() 的基本调用方式
直接调用 py_compile.compile() 是最常用的手动编译方法，它会把 Python 源文件（.py）生成对应的 .pyc 字节码文件，存放在 __pycache__ 目录下。
关键点在于：必须传入源文件的**绝对路径**，否则可能静默失败或写入位置出错；返回值是生成的 .pyc 文件路径（成功时），失败则返回 None。
- 推荐始终使用
abs_path = os.path.abspath("script.py")获取绝对路径 - 如果目标目录不可写（比如只读文件系统），函数不会抛异常，只会返回
None—— 务必检查返回值 - 默认不覆盖已有
.pyc，除非显式传force=True
示例：
import py_compile<br>import os<br><br>src = os.path.abspath("main.py")<br>cfile = py_compile.compile(src, doraise=True)<br>if cfile:<br> print(f"Compiled to: {cfile}")
为什么 compile() 有时不生成 .pyc 或报错？
常见静默失败原因不是语法错误，而是权限或路径问题。比如当前用户对 __pycache__ 所在目录无写权限，或源文件路径是相对路径且工作目录变动后失效。
立即学习“Python免费学习笔记（深入）”；
doraise=True 很关键：它会让编译失败时抛出 py_compile.PyCompileError，而不是默默返回 None。这个异常包含原始错误信息（如 SyntaxError 行号），比检查返回值更可靠。
- 若提示
OSError: [Errno 13] Permission denied，说明__pycache__目录不可写，可手动创建并赋权 - 若源文件含 BOM 或非 UTF-8 编码，
compile()会直接抛SyntaxError，需先用fileencoding工具清理 - 注意 Python 版本差异：3.8+ 默认使用
importlib.util.cache_from_source()规则命名.pyc，旧版本命名不同
如何指定输出路径，绕过 __pycache__？
用 cfile 参数可强制指定字节码输出路径，跳过 __pycache__ 自动管理逻辑。这在构建工具或打包场景中很实用，比如把所有 .pyc 集中到 build/ 目录。
但要注意：cfile 必须是完整路径（含文件名和扩展名），且其父目录必须已存在，否则抛 FileNotFoundError。
- 路径中不能含非法字符（Windows 下避免
< > : " | ? *） - 若指定路径已存在且是目录，会报
IsADirectoryError - 生成的
.pyc不包含源码时间戳校验逻辑，运行时不会自动重编译 —— 这是优势也是风险
示例：
py_compile.compile(<br> "utils.py",<br> cfile="build/utils.cpython-311.pyc",<br> doraise=True<br>)
py_compile vs compile() 内置函数的区别
py_compile.compile() 是面向文件的完整编译流程（解析 → 生成 AST → 生成字节码 → 写磁盘），而内置 compile() 函数只做“内存中编译”，返回 code 对象，不落地、不校验 __future__ 导入兼容性，也不处理编码声明。
- 想动态执行字符串代码？用
compile("x=1", "", "exec") - 想预编译脚本并分发字节码？必须用
py_compile.compile() -
compile()不检查语法是否兼容目标 Python 版本（比如在 3.9 里用match语句编译，再拿到 3.8 运行会崩溃）；py_compile.compile()会按当前解释器版本校验
真正容易被忽略的是：即使你用 py_compile 生成了 .pyc，Python 运行时仍可能因 __pycache__ 权限、字节码魔法数不匹配（跨版本）、或 PYTHONDONTWRITEBYTECODE=1 环境变量而拒绝加载它 —— 编译成功 ≠ 运行时一定用得上。
