c61b599287
- 新增 .github/copilot-instructions.md:Copilot 指令文件,涵盖构建命令、CI 流水线、项目架构、关键规范 - 新增 .github/CODING_STANDARDS.md:完整的代码编写规范文档(TypeScript、React、样式、错误处理、命名、测试、Hook、i18n、存储等 12 个章节) - 新增 11 个目录的 README.md:components、components/ui、config、entrypoints、i18n、lib、pages、providers、public、src、types、utils - 更新 AGENTS.md:补充页面组件模式说明和 components/ui 目录 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
lib/
通用库工具目录,存放与业务无关的底层工具函数。
文件说明
| 文件 | 用途 |
|---|---|
utils.ts |
cn() 函数 — shadcn/ui 标准工具函数 |
cn()
组合 clsx + tailwind-merge,用于合并和去重 Tailwind CSS 类名:
import { cn } from '@/lib/utils';
// 条件类名 + 合并外部 className
<div className={cn(
'flex items-center gap-3 px-3',
isActive && 'bg-primary text-primary-foreground',
className,
)}>
所有需要动态合并 Tailwind 类名的场景都应使用 cn(),而非手动拼接字符串。