雨霖铃
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>
27 lines
683 B
Markdown
27 lines
683 B
Markdown
# lib/
|
|
|
|
通用库工具目录，存放与业务无关的底层工具函数。
|
|
|
|
## 文件说明
|
|
|
|
| 文件 | 用途 |
|
|
| ---------- | ------------------------------------ |
|
|
| `utils.ts` | `cn()` 函数 — shadcn/ui 标准工具函数 |
|
|
|
|
## cn()
|
|
|
|
组合 `clsx` + `tailwind-merge`，用于合并和去重 Tailwind CSS 类名：
|
|
|
|
```typescript
|
|
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()`，而非手动拼接字符串。
|