常见问题 FAQ
1. 为什么叫「灵语」而非中文版 Python?
它是「语法脂译」的 Python 超集:关键字 / 内置名 / 模块 / 方法全部给中文名(token 级脂译为真 Python),执行用 CPython 原生字节码,因此 100% 兼容 Python 3.x 生态。
2. 能直接在 Python 项目里用吗?
能。行为与 Python 完全一致,翻译产物就是标准 Python 代码,可交给 python 运行或 `--export` 导出为 .py 出真码。
3. 灵语是解释器还是编译器?
都不是新引擎:它先做「token 级脂译」(关键字、内置、模块、方法的中文别名在 token 阶段被翻译成对应的 Python 对象),再由 CPython 原生执行——所以没有二次解释开销,错误溯源也是全中文提示。
4. 中文别名从哪来?会不会漏?
内置资产(关键字 / 内置函数 / 标准库模块与常用方法)的中文别名随运行时发布,并由脚本从代码逐字同步生成 `docs/别名对照表.md`,保证与代码一致、查得到。
5. 怎么安装?
详见下载页。桌面工作室提供 exe 绿色版与源码版,命令行可选装到 PATH;也可按 `docs/INSTALL.md` 手动接入 IDE/LSP。
6. 报错信息里的 `名称 'x' 未定义(您是否想用:'xx'?)` 是什么意思?
运行时的全中文溯源提示,还会提示最接近的名字——常见于写错变量名,Windows 下还支持直接用候选名替换。
7. 在线运行的代码安全吗?
每个请求先过危险 API 扫描,任务限 3s 超时、输出 256KB 截断、单账号并发闸,均不可读系统文件;用户文件存于独立沙箱目录并限制大小与后缀名。
8. 「完全手册」是什么?
即 `docs/灵语完全手册.md`,涵盖 35 章:语法全览、词法、类型、运算符、流程控制、函数/类/装饰器、模块与包、标准库中文别名、错误处理、调试、与 Python 互操作等,本站在线版由手册自动生成。
9. 有反馈或交流的地方吗?
「关于」页联系区:反馈邮箱 jzm001687@outlook.com,源码仓库 github.com/jzm3/lingyu(可提 Issues)。