标签系统使用指南

我们的标签系统采用映射优先的方式，既支持友好URL，又保持系统的简洁性。

🎯 工作原理

1. 映射表优先

系统首先检查标签是否在映射表中：

---
title: 我的文章
tags: ["前端", "深圳大学", "随便什么标签"]
---

生成的URL：

• 前端 → /tags/frontend ✅ (在映射表中)
• 深圳大学 → /tags/szu ✅ (在映射表中)
• 随便什么标签 → /tags/%E9%9A%8F%E4%BE%BF%E4%BB%80%E4%B9%88%E6%A0%87%E7%AD%BE (URL编码)

2. 当前映射表

技术相关

• JavaScript → javascript
• React → react
• Next.js → nextjs
• TypeScript → typescript

中文标签

• 前端 → frontend
• 后端 → backend
• 全栈 → fullstack
• 博客 → blog
• 教程 → tutorial
• 笔记 → notes
• 入门 → beginner
• 基础 → basics
• 示例 → example
• 文档 → docs
• 编程 → programming
• 开发环境 → dev-environment
• 工具链 → toolchain
• 最佳实践 → best-practices

学校相关

• 深圳大学 → szu

🚀 使用方式

方式1：直接使用（推荐）

正常在frontmatter中使用标签，无需特殊处理：

tags: ["React", "前端", "我的自定义标签"]

方式2：添加映射（可选）

如果你有常用的中文标签想要友好的URL，在 src/lib/tags.ts 中添加：

export const tagConfig = {
  // ...现有配置...
  '我的常用标签': { slug: 'my-tag', name: '我的常用标签' },
}

📋 最佳实践

✅ 推荐做法

1. 常用标签：为频繁使用的标签添加映射
2. 技术词汇：英文技术词汇保持原样
3. 临时标签：偶尔使用的标签无需映射，使用默认编码即可

⚠️ 注意事项

1. 静态导出：所有可能的标签URL都需要在构建时预生成
2. 编码URL：虽然不够美观，但完全功能正常
3. SEO：搜索引擎能正确处理编码的中文URL

💡 添加新映射

如果你想为某个标签添加友好URL：

1. 编辑 src/lib/tags.ts
2. 在 tagConfig 中添加映射
3. 重新构建项目

例如，为"北京大学"添加映射：

'北京大学': { slug: 'pku', name: '北京大学' },

这样 /tags/pku 就会显示所有"北京大学"相关的内容。

🎉 总结

这个系统的优势：

• 简单直接：大部分情况下无需配置
• 灵活可扩展：重要标签可以自定义友好URL
• 向后兼容：支持所有类型的标签
• SEO友好：重要标签有美观URL，其他标签功能完整

现在你可以自由地使用任何标签，系统会智能地处理URL生成！