Primer CSS 21.3.5版本修复CSS变量缺失问题

在Primer CSS 21.3.2至21.3.4版本中，开发者在使用静态站点引入Primer CSS时遇到了一个显著问题：许多基础CSS变量（primitives variables）未被正确加载。这个问题影响了那些按照官方文档指引，仅通过引入primer.css文件来使用该框架的开发者。

问题背景

Primer CSS是GitHub设计系统的实现，提供了一套完整的CSS工具集。在21.3.2版本之前，开发者只需在HTML中引入一个CSS文件即可获得完整的样式系统，包括所有的基础变量。然而，从21.3.2版本开始，许多开发者发现他们的站点样式出现了异常，因为关键的CSS变量没有被定义。

问题表现

受影响的项目中，开发者观察到：

1. 颜色变量等基础样式变量缺失
2. 即使正确设置了data-color-mode和data-light/dark-theme属性，问题依然存在
3. 需要额外引入primitives.css文件才能恢复正常

技术原因

这个问题源于21.3.2版本中对主题文件的改动。在该版本中，Primer CSS团队重构了主题系统的实现方式，意外导致了基础变量没有被正确打包到主CSS文件中。这种变化使得原本依赖这些变量的组件和样式无法正常工作。

解决方案

Primer CSS团队在21.3.5版本中修复了这个问题。现在开发者可以：

1. 升级到21.3.5或更高版本
2. 继续使用单一CSS文件引入方式
3. 无需额外引入primitives.css文件

最佳实践

对于使用Primer CSS的开发者，建议：

1. 定期检查并更新Primer CSS版本
2. 在升级时注意查看变更日志
3. 如果遇到类似问题，可以临时通过引入primitives.css文件作为应急方案
4. 确保正确设置data-color-mode和theme相关属性

这个问题的修复体现了Primer CSS团队对开发者体验的重视，也提醒我们在使用开源框架时需要注意版本更新带来的潜在影响。