tetris/assets/fonts

🎨 字体系统说明 / Font System Guide

✅ 优化完成 / Optimization Complete

游戏现在只使用 assets/fonts 目录中的字体！
不再依赖系统字体，确保跨平台一致性。

当前状态 / Current Status

• 使用中的字体: HYSongYunLangHeiW-1.ttf (3.6MB)
• 字体系统: 已优化为仅使用项目本地字体
• 状态: ✅ 正常运行，无错误

---

🔧 字体管理 / Font Management

快速设置 / Quick Setup

运行字体设置脚本：

./scripts/setup_fonts.sh

提供以下功能：

• 🏆 从 Windows 系统复制微软雅黑
• 📥 下载开源中文字体
• 📖 字体放置说明
• 🧪 测试字体配置
• 🧹 清理字体目录

手动添加字体 / Manual Font Addition

1. 将字体文件放入此目录

   cp your_font.ttf assets/fonts/
   

2. 重新编译游戏

   make build
   

3. 运行游戏

   ./tetris
   

---

📊 字体优先级 / Font Priority

游戏按以下优先级选择字体：

🥇 微软雅黑系列
   ├── msyh.ttf, yahei.ttf
   └── microsoft*.ttf

🥈 思源/Noto 系列  
   ├── noto*.ttf, source*.ttf
   └── 思源*.ttf

🥉 苹果字体系列
   ├── pingfang*.ttf
   └── hiragino*.ttf

🏅 其他中文字体
   ├── simhei*.ttf, 宋*.ttf
   └── 任意可用字体

🆘 最终回退
   └── Go 默认字体

---

📋 支持的格式 / Supported Formats

格式	支持状态	说明
.ttf	✅ 完全支持	推荐使用
.otf	✅ 完全支持	OpenType 字体
.ttc	⚠️ 部分支持	可能不兼容，建议转换为 TTF

---

🚀 推荐字体 / Recommended Fonts

微软雅黑 / Microsoft YaHei (推荐)

# 从 Windows 系统复制
cp /mnt/c/Windows/Fonts/msyh.ttc assets/fonts/
# 或 TTF 格式
cp /path/to/msyh.ttf assets/fonts/

开源替代 / Open Source Alternatives

• Noto Sans CJK - Google 开源中文字体
• 思源黑体 - Adobe/Google 联合开发
• 文泉驿微米黑 - 经典开源中文字体

---

🛠️ 故障排除 / Troubleshooting

常见问题 / Common Issues

❌ "collections not allowed" 错误

• 解决方案: 使用 TTF 格式而不是 TTC
• 或者使用脚本下载开源字体

❌ 中文显示为方块

• 检查字体是否支持中文字符集
• 确认字体文件完整

❌ 字体未加载

• 检查文件权限: chmod 644 assets/fonts/*.ttf
• 查看启动日志: ./tetris 2>&1 | grep 字体

调试信息 / Debug Info

查看字体加载详情：

./tetris 2>&1 | grep -E "(字体|🎨|✅|❌)"

正常输出示例：

🔍 在 assets/fonts 目录找到 1 个字体文件
✅ 使用项目字体: assets/fonts/your_font.ttf
🎨 字体系统初始化完成，使用: assets/fonts/your_font.ttf

---

💡 优化特点 / Optimization Features

• 🎯 专用目录: 只使用 assets/fonts 目录
• 🚀 智能选择: 自动选择最适合的字体
• 🔍 详细日志: 完整的字体加载信息
• ⚡ 快速回退: 无字体时使用默认字体
• 🌐 跨平台: 不依赖系统字体路径

---

⚠️ 版权声明 / Copyright Notice

微软雅黑字体受版权保护，请确保您有合法使用权限。

推荐使用开源字体：

• Noto Sans CJK (Apache License 2.0)
• 文泉驿微米黑 (GPL)
• 阿里巴巴普惠体 (免费商用)

---

🎉 字体系统已优化完成！享受一致的中文显示效果！