安装

库名叫做tkfluent，但导入时要使用tkflu这缩减名称

用PIP下载

pip install tkfluent

中国国内镜像源

pip install tkfluent -i https://pypi.tuna.tsinghua.edu.cn/simple

从Github下载

从Releases下载tkfluent-x.x.x-py3-none-any.whl

注意替换本地下载的文件名

pip install tkfluent-x.x.x-py3-none-any.whl

克隆项目并编译安装

由于本项目是使用poetry打包的，所以需要安装poetry进行编译

pip install poetry -U

中国国内镜像源

pip install poetry -U -i https://pypi.tuna.tsinghua.edu.cn/simple

克隆项目至本地

git clone https://github.com/XiangQinxi/tkfluent.git

编译并安装

cd tkfluent
poetry install
poetry build
pip install dist/tkfluent-x.x.x-py3-none-any.whl

版本要求：tkfluent 0.2.0 需要 tkdeft >= 0.2.0

tkfluent 的绘制后端由 tkdeft 提供。从 0.2.0 开始，tkdeft 增加了可插拔的绘制引擎层（tkdeft.engines）， skia / pillow / cairo 这几个进程内栅格引擎都在里面。

如果环境里还是旧版 tkdeft，导入 tkflu 时会看到：

ModuleNotFoundError: No module named 'tkdeft.engines'

怎么修

正常 pip install tkfluent 会自动带上正确的 tkdeft。只有在本地开发（两个仓库都在本机）时才容易踩到，因为 IDE 会把项目根加进 sys.path，于是 import tkflu 用的是本地新代码，而 tkdeft 仍解析到 site-packages 里的旧版本。

最稳的做法是把两个仓库都装成"可编辑"模式：

pip install -e ../tkdeft      # 先装被依赖的
pip install -e .              # 再装 tkfluent

装完可以用一句话确认环境是否正确：

python -c "import tkdeft; print(tkdeft.__version__, tkdeft.__file__)"
# 期望输出 0.2.0 以及你本地 tkdeft 仓库的路径

也可以临时用环境变量指定，不安装：

set PYTHONPATH=C:\path\to\tkdeft        # Windows
export PYTHONPATH=/path/to/tkdeft       # macOS / Linux

关于 Pillow 版本

tkdeft / tkfluent 对 Pillow 不设上界（>=10.2）， Pillow 10 / 11 / 12 均已实测可用。这样安装时不会把你环境里已经装好的新版 Pillow 降级。