Repository navigation
ChinesePython 0.1.1(Windows x64)
说中文的 Python:中文关键字 + 中文标准库 API + 中文报错;与英文可混写,英文原名一直可用;基于 CPython 3.14.7(fork),自带 pip,解压即用。
下载哪个
ChinesePython-0.1.1-win64.zip(本附件,约 46 MB,解压后约 160 MB,含官方英文 HTML 文档):绿色免安装包,解压后双击启动.cmd即进中文 REPL;
包里另附用户手册.md(关键字全表/已汉化库清单/怎么切回英文)、中文对照表.md(英文名 ⇄ 中文名总表)、常见问题.md(FAQ)。- 和官方 Windows 版一样齐全:带
Lib\test官方测试套(python -m test可用)、Lib\idlelib(IDLE)、include\+libs\(Python.h/python314.lib——pip install编译 C 扩展可用)、测试用扩展模块(_testcapi等),以及预装好的 pip。 - 或者直接 clone 本仓(
git clone https://github.com/YoloLogic/ChinesePython.git)——仓里就是同一套东西的bin\+Lib\布局,跑一次一键安装.cmd把bin\加进用户 PATH。
快速开始
导入 操作系统 作为 操
来自 并行.futures 导入 线程池执行器
定义 平方(甲):
返回 甲 * 甲
使用 线程池执行器(2) 作为 池:
打印([任务.result() 对于 任务 属于 [池.submit(平方, 数字) 对于 数字 属于 range(4)]])装第三方包:python -m pip install 包名。
这一版有什么
- 中文关键字:
定义/类型/返回/如果/否则/对于/属于/使用/作为/尝试/捕获/导入/来自 … 导入 …/并且/或者/并非/空值/真值/假值/异步/等待…(硬 35 + 软 3,全表见用户手册.md) - 中文标准库 API:157 个库已铺(112 个单文件模块 + 25 个包 + 20 个包装层)——
操作系统、路径库、JSON解析、正则、并行.futures、多进程、套接字、压缩包、电子邮件、SQLite数据库、虚拟环境、确保pip、异步IO、单元测试、导入机制…;每个中文名对应的英文名见中文对照表.md - 中文报错(显示层):
除零错误: 除以零;str(e)、异常类名仍是英文(有意设计,日志与except判断不受影响) - 一键切回英文报错:环境变量
CHINESEPYTHON_ERRORS=en—— 100% 还原 CPython 原样(both中英并排,排查用) --build-info构建身份:python --build-info打印全量改动文件的联合哈希(唯一身份)+python314.dll的 SHA-256(当场实测,与生成时并排)+ 两仓 HEAD + 词表/生成器哈希 + 预装 pip 版本;dll 被换过会当场显示不一致- 官方英文 HTML 文档(
Doc\html\,592 个文件):官方 CPython 3.13.7 那份的副本(我们的解释器是 3.14.7,差异处以 3.14 为准);每页顶部加了一条横幅,另有一页Doc\html\中文入口.html(中文关键字全表 + 141 个中文库名 → 官方文档页 + 中文报错说明) - 两个单文件 exe(另附,不在 zip 里):
ChinesePython.exe(便携解释器 ——ChinesePython.exe 脚本.py直接用,首次运行解包到%LOCALAPPDATA%\ChinesePython\,之后走缓存,换版本会自动清旧缓存)与ChinesePython-install.exe(自解压 —— 解包到自己目录 + 跑一遍包内自检,不擅自改 PATH) - VS Code 扩展(附件
chinesepython-0.1.1.vsix(zip 的editors\dist\里也有一份),6.5 KB):给.py里的中文关键字加高亮(注入式,不替换内置 Python 语法,英文高亮照旧)+ 38 条中文片段;覆盖 202 个名字(38 关键字 + 74 内置名 + 85 异常名 + 5 模块孪生属性)。装:code --install-extension chinesepython-0.1.0.vsix(或在扩展面板「从 VSIX 安装」)。包里带源哈希,可核出处。 - VS Code 一键装配 kit(在 zip 的
editors\里):editors\vscode-kit\(三份配置 + 中文示例)+一键装配到我的VSCode.cmd(重打扩展 + 装 + 先备份你的.vscode配置;一键还原.cmd一键回退) - 能在 Linux 上跑:解释器本体从源码可构建(实测 Ubuntu 24.04:45,787 个官方用例只剩 14 个已知差异;我们自己的 37 套冒烟全过)—— 发行包本身仍是 Windows 专用(zip / 单文件 exe / 一键安装 / 签名)
- 自带 pip 26.2.1(预装好,开箱可用)
自检与卸载
powershell -ExecutionPolicy Bypass -File verify.ps1 # 八项自检(中文标准库/关键字/报错/英文还原/pip/官方英文文档/安装脚本布局/VS Code kit)
powershell -ExecutionPolicy Bypass -File install.ps1 -卸载已知限制
- 报错显示是中文,
str(e)/ 异常类名是英文(有意设计,可用上面那个环境变量整体还原); - 少数库只翻了一部分,另有一批库未汉化(
tkinter/zoneinfo/site/warnings…,共 28 个,都有台账记录)—— 这些库的英文版照旧可用; - pickle 协议 <4 写不了中文模块名,用协议 4/5(即默认的
HIGHEST_PROTOCOL); - 第三方库(pip 装的)仍是英文 API;编辑器的语法高亮可能不认识中文关键字(不影响运行)。
许可
基于 CPython 3.14.7 fork(上游 PSF 许可完整保留,见 LICENSE.txt;上游 https://github.com/python/cpython );本项目自身部分以 MIT 发布(LICENSE-MIT)。详见 NOTICE.txt。
附件校验和(SHA-256)
| 附件 | 字节 | SHA-256 |
|---|---|---|
| ChinesePython-0.1.1-win64.zip | 48313584 | 54722a3e0528b4dd0edf446350126c78218bb38d6b8a5329309c8e622808f5bd |
| ChinesePython.exe | 48490248 | 76b59a861c55c670c71d0a9bc6dee06d19b54a815ab66d06d282eb2d39c7344d |
| ChinesePython-install.exe | 48490760 | 23dc909d8e90f6f62853488eca1449056b8a1018d37fafa631d7e57ad4d68439 |
| ChinesePython-signing.cer | 1138 | ebba8155fbde0c2bb76d86c3954f4b6f7ff1dddfd349c9d02405b663ac0dc704 |
| chinesepython-0.1.1.vsix | 9952 | 8fbfb1e37e37a03adb4fbaad4243c705aa839b5f6b272e811d9fa03142936d3a |
自己核一遍(下载后照着敲):
powershell
Get-FileHash .\ChinesePython-0.1.1-win64.zip -Algorithm SHA256
核不上的别装。另:两个 exe 与包内 exe 是自签证书签的(发布者 YoloLogic,带时间戳),
用它验「下来的是我们发的、没被换过」够用;Windows 仍会提示「未知发布者」——
因为我们没有受信任 CA 的证书,这是常态,不是文件有问题。装不装公开证书都随你,见常见问题。