Skip to content

ChinesePython 0.1.1(Windows x64)

Latest

Choose a tag to compare

@YoloLogic YoloLogic released this 07 Oct 08:29
· 3 commits to main since this release

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 的证书,这是常态,不是文件有问题。装不装公开证书都随你,见常见问题。