Cython 默认启用注解类型检查，而 Typer 的 Argument/Option 等对象并非纯 Python 类型（如 str），导致编译后二进制在初始化时抛出 TypeError: Expected str, got ArgumentInfo。禁用 annotation_typing 并显式指定语言级别即可解决。
cython 默认启用注解类型检查，而 typer 的 `argument`/`option` 等对象并非纯 python 类型（如 `str`），导致编译后二进制在初始化时抛出 `typeerror: expected str, got argumentinfo`。禁用 `annotation_typing` 并显式指定语言级别即可解决。
当你使用 Cython 将基于 Typer 的 Python 脚本（如 main.py）编译为独立二进制时，即使源码能被 python3 main.py 正常执行，生成的可执行文件却在导入阶段崩溃：
Traceback (most recent call last):
File "main.py", line 87, in init main
key_id: str = typer.Argument(None),
TypeError: Expected str, got ArgumentInfo
根本原因在于：Cython 在 --embed 模式下默认启用严格的类型注解验证（annotation_typing = True）。它会尝试将类型提示（如 str）与右侧赋值的实际对象（这里是 typer.Argument(None)，返回 ArgumentInfo 实例）进行静态匹配——而这在语义上不成立，从而触发运行时异常。
✅ 正确解决方案是在源文件顶部添加 Cython 编译指令，显式关闭注解类型检查，并统一语言级别：
#cython: annotation_typing = False
#cython: language_level = 3
import typer
app = typer.Typer()
@app.command()
def show_code(
key_id: str = typer.Argument(None),
issuer_name: str = typer.Option(None),
e: bool = typer.Option(False, help="Show TOTP code of a key outside key file.")
):
# ... your logic
pass
⚠️ 注意：#cython: 指令必须位于文件最开头（允许前导空行或 # 注释），且需独占一行；language_level=3 可避免因隐式 3str 行为引发的兼容性警告（如你构建日志中所示）。
? 推荐后续优化：改用 setup.py + cythonize 实现标准化构建，提升可维护性与跨环境一致性：
# setup.py
from setuptools import setup
from Cython.Build import cythonize
from Cython.Distutils import build_ext
import numpy
setup(
ext_modules = cythonize(
"main.py",
compiler_directives={
'annotation_typing': False,
'language_level': 3,
},
embed=True # 启用嵌入式主函数
),
options={'build_ext': {'inplace': True}},
)
构建命令：
python setup.py build_ext --inplace
gcc -Os $(python3-config --includes) main.c -o pyauth \
$(python3-config --ldflags) -lpython$(python3-config --version | sed 's/\..*//')m
? 总结：Cython 不是“黑盒替代 Python 解释器”，而是带强类型约束的编译器。对依赖动态注解框架（如 Typer、Click、Pydantic）的项目，务必主动配置 annotation_typing = False，并始终显式声明 language_level。这既能绕过类型误判，又能确保行为与 CPython 一致——最终获得轻量、快速、可靠的原生二进制。
