Cython 默认启用注解类型检查，而 Typer 的 typer.Argument/typer.Option 等对象并非运行时字符串，导致编译后报错 TypeError: Expected str, got ArgumentInfo；禁用 annotation_typing 并显式指定语言级别可解决该问题。
cython 默认启用注解类型检查，而 typer 的 `typer.argument`/`typer.option` 等对象并非运行时字符串，导致编译后报错 `typeerror: expected str, got argumentinfo`；禁用 `annotation_typing` 并显式指定语言级别可解决该问题。
Cython 将 Python 源码编译为 C 代码时，默认行为与 CPython 解释器存在关键差异：它会对类型注解进行静态验证（尤其在 language_level=3 下），而 Typer 的参数声明（如 typer.Argument(None)）本质是运行时构造的配置对象，并非字面量 str。当 Cython 尝试将 key_id: str = typer.Argument(None) 中的 str 注解与右侧 ArgumentInfo 实例做类型匹配时，即触发 TypeError。
✅ 正确解决方案是在源文件顶部添加 Cython 编译指令，显式关闭注解类型检查并固定语言级别：
# main.py
#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 here
pass⚠️ 注意事项：
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- #cython: 指令必须位于文件开头（前几行，无空行隔开），否则会被忽略；
- language_level=3 明确启用 Python 3 语义（如 print 为函数、str 为 Unicode），避免兼容性警告；
- annotation_typing = False 是关键：它禁用对注解类型与默认值一致性校验，使 Typer 等依赖动态注解的库可正常工作；
- 不建议依赖 --embed 后手动调用 gcc —— 推荐改用标准 setup.py 构建流程，更可靠且便于管理依赖：
# 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}),
cmdclass = {'build_ext': build_ext},
)构建命令：
立即学习“Python免费学习笔记（深入）”；
python setup.py build_ext --inplace # 或生成独立可执行文件（需额外配置） python setup.py build_ext --inplace && gcc -Os $(python3-config --includes) main.c -o pyauth $(python3-config --ldflags) -lpython3.11m
? 总结：Cython 不是“透明替换解释器”的工具，而是带有自身语义规则的编译器。涉及框架级注解（Typer、Pydantic、FastAPI 等）时，务必查阅其 Cython 兼容性文档，并通过 compiler_directives 或源码指令显式配置行为。相比 PyInstaller，Cython 生成的二进制体积更小、启动更快，但需更精细的构建控制。
