该技能名为 Optimized Next.js TypeScript,定位为 Next.js 与 TypeScript 的优化最佳实践指南,目标是帮助开发者创建高度优化且可维护的 Next.js 解决方案,遵循性能、安全和整洁架构方面的最佳实践。
用途 该技能面向使用 Next.js 和 TypeScript 的开发者,提供一套编码与架构规范,用于指导日常开发中的技术选型、代码组织、性能优化、安全防护、测试与文档编写。
主要能力
- 代码风格与结构:编写简洁、技术性的 TypeScript,采用函数式、声明式模式;避免使用类,倾向于组合与模块化;使用带辅助动词的描述性变量名(如 isLoading、hasError);按导出组件、子组件、辅助函数、静态内容和类型来组织文件;目录命名使用小写加连字符。
- 优化最佳实践:尽量减少 'use client'、useEffect 和 setState 的使用,优先使用 React Server Components;实现动态导入以进行代码分割;采用移动优先的响应式设计;使用 WebP 格式、尺寸数据和懒加载来优化图片。
- 错误处理与校验:优先考虑全面的错误处理和边界情况;使用提前返回和守卫子句处理前置条件;实现自定义错误类型以保持一致性;严格校验用户输入。
- UI 与样式:利用现代框架,如 Tailwind CSS、Shadcn UI、Radix UI;保持一致、响应式的设计模式。
- 状态与数据管理:使用 Zustand 或 TanStack React Query 进行状态管理和数据获取;使用 Zod 进行模式校验。
- 安全与性能:应用适当的错误处理和输入校验;遵循性能优化技术以改善加载时间和渲染。
- 测试与文档:编写 Jest 和 React Testing Library 单元测试;包含 JSDoc 注释以支持 IDE 智能感知;清晰地记录复杂逻辑。
使用方式 该技能以最佳实践指南的形式提供,开发者可在编写 Next.js + TypeScript 项目时参照其规范进行开发。资料中未提供具体的安装命令、代码示例或集成步骤。
适用场景 适用于需要构建高性能、安全且架构整洁的 Next.js 应用的开发场景,尤其适合关注 React Server Components、代码分割、响应式设计、状态管理选型、输入校验和单元测试的团队或个人开发者。
限制 资料中未提供该技能的具体安装方式、运行环境要求、版本兼容性、收费模式或价格信息,也未提供可直接运行的代码示例。