项目技术规范

发表于 2025-02-06 00:00 211 字 2 min read

猪京京 avatar

猪京京

猪京京的数字花园,记录学习、思考和探索的空间

项目开发技术规范和最佳实践

项目技术规范

代码风格

TypeScript

  • 使用 2 空格缩进
  • 使用单引号
  • 行尾不加分号
  • 使用箭头函数

组件命名

  • 组件使用 PascalCase
  • 工具函数使用 camelCase
  • 常量使用 UPPER_SNAKE_CASE

项目结构

src/
├── components/     # 可复用组件
├── constants/      # 常量配置
├── layouts/        # 布局组件
├── lib/            # 工具库
├── pages/          # 页面
└── styles/         # 样式

提交规范

使用 Conventional Commits:

  • feat: 新功能
  • fix: 修复 bug
  • docs: 文档更新
  • style: 代码格式
  • refactor: 重构
  • test: 测试
  • chore: 构建过程

性能要求

  • 首屏加载时间 < 2s
  • Lighthouse 性能分数 > 90
  • 图片使用 WebP 格式
  • 启用代码分割

安全规范

  • 不在前端暴露敏感信息
  • 所有 API 请求使用 HTTPS
  • 用户输入必须进行验证和转义
© 2025 - 2026 猪京京 @pigthinktank
Powered by theme astro-koharu · Inspired by Shoka