意为灵巧，灵活轻巧好用
一句话：把矢量绘图变成 Tkinter 控件的底座。
开发中
注意
用这套零件搭出来的组件库长这样（tkfluent）：
| 浅色 | 深色 |
|---|---|
 |
 |
原理
一句话：先用矢量绘图生成图片，再交给 Canvas / Label 显示出来。
具体走哪条路是可切换的：
| 方式 | 过程 |
|---|---|
SVG 引擎（默认 tksvg） |
svgwrite 生成 SVG → 写临时文件 → tksvg 读回来栅格化 |
栅格引擎（skia / pillow / cairo） |
进程内直接画到位图，完全不碰磁盘 |
这其中还是有些坑的（比如图片不显示——那其实是
PhotoImage被垃圾回收导致的）， 完整清单见文档站的常见问题与排查。
快速上手
pip install -U tkdeft
import tkinter
from tkdeft.windows.canvas import DCanvas
root = tkinter.Tk()
canvas = DCanvas(root, width=240, height=120, background="#f3f3f3")
canvas.pack()
# 一行画图元：栅格引擎走进程内快速路径，否则自动回退 SVG
canvas.draw_roundrect(20, 20, 200, 76, 8,
fill="#ffffff", outline="#000000", outline_opacity=0.25)
root.mainloop()
完整文档（安装 / 快速上手 / 概念与架构 / 指南 / API）： https://tkdeft.netlify.app
绘制引擎
tkdeft 把"画什么"和"用什么画"分开了。组件只需要描述一个
RoundRectSpec（尺寸、圆角、填充、描边……），具体由哪个引擎栅格化是可切换的。
同一份规格交给 5 个引擎：
from tkdeft.engines import set_engine, list_engines, describe_engines, cache_stats
print(list_engines()) # {'tksvg': True, 'wand': True, 'skia': True, ...}
set_engine("skia") # 或 set_engine(2)
print(cache_stats()) # 缓存命中率，便于诊断
| 编号 | 引擎 | 类型 | 说明 | 额外依赖 |
|---|---|---|---|---|
| 0 | tksvg |
SVG | 默认，保持既有行为 | 无 |
| 1 | wand |
SVG | 经 Wand(ImageMagick) 转 PNG | Wand |
| 2 | skia |
栅格 | skia-python，进程内出图，画质与速度最好 | pip install tkdeft[skia] |
| 3 | pillow |
栅格 | Pillow 超采样，永远可用 | 无（Pillow 是硬依赖） |
| 4 | cairo |
栅格 | pycairo | pip install tkdeft[cairo] |
栅格引擎不写临时文件、不解析 SVG、不碰磁盘；渲染结果按规格缓存， 同尺寸同配色的一组控件共用同一张图片。
实测（120×32 圆角矩形，本机）
| 场景 | 优化前 | 仅修基础设施 | + skia 引擎 |
|---|---|---|---|
| 圆角矩形（尺寸各异） | 13.81 ms | 4.94 ms | 1.26 ms |
| 圆角矩形（参数相同） | 10.80 ms | 4.33 ms | 0.02 ms |
| 按钮重绘 | 5.95 ms | 2.86 ms | 0.15 ms |
| 按钮 hover 往返 | 13.65 ms | 6.08 ms | 0.26 ms |
| 20 个按钮批量重绘 | 139.9 ms | 110.4 ms | 2.93 ms |
复现：python benchmarks/run_all.py（9 项回归 + 性能基准，详见
回归与性能）
已修复的缺陷
这一轮审查中定位并修掉的真实问题（都不是"风格问题"）：
| 问题 | 影响 |
|---|---|
DSvgDraw.temppath() 每次调用都 mkstemp() 且从不关闭返回的 fd |
每绘制一帧泄漏一个句柄，并在临时目录留下一个残留文件 |
DDrawWidget.__init__ 一次性 mkstemp() 四个临时文件 |
每个控件创建即泄漏 4 个句柄（20 个按钮 = 80 个） |
DCanvas.create_round_rectangle 只把图片存进 self._img / self._tkimg |
同一画布上多张图片时，除最后一张外都会被 GC，画布 item 变空白 |
RenderManager._render_all 调用 widget.winfo_zorder() |
tkinter 没有这个方法，只要有脏控件就抛 AttributeError |
RenderManager._schedule_render 里 tk._default_root or list(...)[0] |
两者都不可用时 IndexError |
_draw 结尾又 mark_dirty(self) |
集中式调度下同一控件被重绘两遍 |
svgwrite 生成的矩形用 translate(0.5,0.5) + 整宽整高 |
描边中心线压在画布边界上，外侧半个线宽被裁掉 |
create_svg_image 对 way 未做兜底 |
回退路径遇到非 0/1 的渲染器编号会直接失败 |
tkdeft.svg 把 None / "transparent" 直接交给 svgwrite |
栅格引擎认这两者，svgwrite 只认 "none" → 同一份规格换了引擎就 TypeError |
计划
未来我打算先制作出SunValley设计的库然后就去做别的项目，tkfluent
至于完整文档，我后面会加紧制作的。
设计来源： https://pixso.cn/community/file/ItC5JH1TOwj15EeOPcY7LQ?from_share
为什么不像tkadw一样做跟易用的主题？
因为svg能实现很多漂亮的组件，而我套的模板可能不对其它设计起太大的作用
所以我将这个设计库放在这里当做模板，供其它设计者参考使用。
更新日志
版本变更统一记录在文档站的更新日志里
（源文件在 docs/docs/blog/posts/），按时间倒序排列：
| 版本 | 一句话 | 发布说明 |
|---|---|---|
0.3.0 |
把对外接口补齐：统一绘制入口、引擎查询、DObject 补全 |
2026-09-13 |
0.2.0 |
可插拔绘制引擎层 + 进程内栅格引擎 + 规格缓存 | 2026-09-12 |
0.1.0 |
完善功能 | 2025-06-26 |
| 更早 | 0.0.1 – 0.0.9 的起步阶段 |
回顾 |
1 maintainer
Metadata
1 maintainer
Release files for tkdeft 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tkdeft-0.3.0.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tkdeft-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / tkdeft-0.3.0.tar.gz
| Download URL | tkdeft-0.3.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8c446055fb0bccbafb3247875d2dca98b2133611958ba147f842a56de8fe4c89
|
|
BLAKE2b-256 checksum How to use checksums |
c1ec5dc7a88ee3d6c2db891a7c0674a2cd6e6ae036e7e01722a25118fe3ae8a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.13.5 Windows/11
|
Release files / tkdeft-0.3.0-py3-none-any.whl
| Download URL | tkdeft-0.3.0-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bef5ddbf3c0306e4ebc846b3186e8db082517d0bfeb720c2c17008cead7f2b7b
|
|
BLAKE2b-256 checksum How to use checksums |
cf4666b4aeabebbff9e0e862f249a0ab7ae7bb47e6fb4231197b28d9239588b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.13.5 Windows/11
|
