index.md 2.5 KB

前端项目常见问题检查清单

项目检查

代码规范

  • 是否符合代码规范?

模版渲染项目

  • [ ] 使用正确使用对应环境的模版变量?

    # 剑鱼项目 PC / WX 端 CDN 模版变量前缀
    {{Msg "seo" "cdn"}}
        
    # 剑鱼项目 APP 端 CDN 模版变量前缀
    {{Cdns .Host "seo" "cdn"|SafeUrl}}
      
    # 资源版本后缀
    {{Msg "seo" "version"}}
      
    # 模版变量全局统一获取,使用方式
    window.goTemplateData
    
    <link href='{{Msg "seo" "cdn"}}/pccss/reset_pc.css?v={{Msg "seo" "version"}}' rel="stylesheet" type="text/css"/>
      
    <script src='{{Cdns .Host "seo" "cdn"|SafeUrl}}/jyapp/js/common.js?v={{Msg "seo" "version"}}'></script>
    
  • [ ] 是否引用跨端资源?

    该问题将导致生产环境因跨域无法正确访问资源

    剑鱼项目中 app 资源与 pc/wx 资源隔离,生产环境域名隔离,如需使用跨端共享资源,需使用 common-module 资源目录

    <script src='{{Msg "seo" "cdn"}}/common-module/public/js/china-map-data.js?v={{Msg "seo" "version"}}'></script>
    <script src='{{Cdns .Host "seo" "cdn"|SafeUrl}}/common-module/public/js/china-map-data.js?v={{Msg "seo" "version"}}'></script>
    

前后的分离项目

  • [ ] 使用正确的剑鱼 CDN 资源?

    <script src=//cdn-common.jianyu360.com/cdn/lib/vue/2.6.11/vue.min.js></script>
    <script src=//cdn-common.jianyu360.com/cdn/lib/vant/2.12.24/lib/vant.min.js></script>
    
  • [ ] 新增的项目依赖版本是否锁定?是否已更新至 CDN?

资源检查

图标

  • iconfont剑鱼图标库中是否存在该图标? > 优化采用 iconfont 图标

图片

  • 图片是否使用二倍图?
  • 图片(大于 100K)是否进行压缩?
  • 图片(大于 300K)是否进行渐进式渲染支持?

JS三方库

  • 三方库是否使用剑鱼CDN引用?

常见问题检查

CSS

  • 无特殊字体时,是否重复定义 font-family? > 从蓝湖 / Figma 中复用样式代码时,除特殊字体外,不应设置 font-family,该问题将导致跨平台字体差异

JS

  • 非Babel项目,PC端 语法是否兼容IE11? > 使用 can i use 网站进行判断
  • 不兼容语法是否进行使用前前置判断?

埋点

  • 可交互按钮、区域是否添加唯一语义化 ID?
  • 新增页面、项目是否正常引用埋点SDK? > 验证页面是否加载 huiju、baidu域名的 SDK >
    > 点击按钮验证是否有埋点请求