跳到正文

COMMUNITY / FAILURE ARCHIVE

让失败成为可复用的经验

记录真实的问题、环境、原因和修复。每条记录都保留代码或提交依据。

Tailwind 字体变量自引用导致字体回退

问题
页面英文字体回退,排版宽度与预期不一致。
环境
Next.js 16 / Tailwind CSS 4 / Windows 浏览器
原因
--font-sans 间接引用自身,无法形成有效字体列表。
解决方式
在 @theme 中定义明确的系统字体栈;中英文与等宽字体分别配置。
如何验证
检查 computed font-family,并在 320px / 390px / 桌面宽度检查换行。

Python 子进程跨平台文本编码不一致

问题
包含非 ASCII 项目名称时,命令行测试可能受系统默认编码影响。
环境
Python 3.11+ / Windows 与 Linux / unittest
原因
父进程与子进程默认文本编码不一定相同。
解决方式
课程测试显式指定 UTF-8 文本解码,并通过 -X utf8 约定子进程输出编码。
如何验证
运行课程 test_lab03.py,并在 Windows / Linux 的 CI 矩阵复核。