[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"donations-sidebar":3,"$fKdzyV3tw3xw815M8KCwGQa5wRTnVkEm1GCC1sPuKf4Q":4,"sidebar-data":9,"posts-{\"page\":1,\"pageSize\":10,\"tagId\":\"be7b10bc-49eb-4a03-bea7-ceb915d500fe\"}":353},[],{"id":5,"name":6,"slug":6,"createdAt":7,"updatedAt":8},"be7b10bc-49eb-4a03-bea7-ceb915d500fe","规范","2022-07-16T14:41:06.000Z","2023-02-08T02:49:14.000Z",{"categories":10,"tags":98,"postCount":279,"tagCount":280,"hotPosts":281},[11,19,25,32,38,45,52,56,63,67,71,77,83,88,92],{"id":12,"name":13,"slug":14,"description":15,"sortOrder":16,"createdAt":17,"updatedAt":17,"postCount":18},"e8d0bd45-d10c-46d3-8afb-0c072df7f8a7","技术","tech","技术文章",0,"2026-06-27T04:18:37.371Z",1,{"id":20,"name":21,"slug":22,"description":21,"sortOrder":18,"createdAt":23,"updatedAt":8,"postCount":24},"15ac46ad-edf7-4435-9a64-ff78117d58c5","Vue3 生态","vue3-生态","2022-05-21T08:05:39.000Z",6,{"id":26,"name":27,"slug":28,"description":27,"sortOrder":29,"createdAt":30,"updatedAt":8,"postCount":31},"11d4d397-685c-4180-a7b3-9b0e3a1e411e","Css","css",2,"2022-05-23T07:19:37.000Z",9,{"id":33,"name":34,"slug":34,"description":34,"sortOrder":35,"createdAt":36,"updatedAt":8,"postCount":37},"d10456a5-e649-4741-a38f-f07f266ce5f2","开发环境",3,"2022-05-24T01:52:41.000Z",13,{"id":39,"name":40,"slug":41,"description":40,"sortOrder":42,"createdAt":43,"updatedAt":8,"postCount":44},"5ed5cc62-43ea-49a2-b0b2-38bc7aae52a0","Vue3","vue3",4,"2022-05-24T01:55:05.000Z",8,{"id":46,"name":47,"slug":48,"description":47,"sortOrder":49,"createdAt":50,"updatedAt":8,"postCount":51},"da130ba9-d4f4-49f3-aa0f-149078097ef0","JavaScript","javascript",5,"2022-05-24T02:22:57.000Z",18,{"id":53,"name":54,"slug":54,"description":54,"sortOrder":24,"createdAt":55,"updatedAt":8,"postCount":18},"d8cbe380-54b3-4a61-a12d-5438c2918574","限时优惠","2022-05-25T07:18:03.000Z",{"id":57,"name":58,"slug":59,"description":58,"sortOrder":60,"createdAt":61,"updatedAt":8,"postCount":62},"e0f3b8d8-cfe7-41fb-802b-a79699d95968","JavaScript插件","javascript插件",7,"2022-06-01T14:08:31.000Z",16,{"id":64,"name":65,"slug":65,"description":65,"sortOrder":44,"createdAt":66,"updatedAt":8,"postCount":24},"4ea3d8af-9cc3-49bb-a9cd-34dbcdc3bd85","构建工具","2022-06-02T07:28:13.000Z",{"id":68,"name":69,"slug":69,"description":69,"sortOrder":31,"createdAt":70,"updatedAt":8,"postCount":44},"9ed9827c-9cbb-42da-80e4-d04c7fdba886","开发工具","2022-06-21T03:35:05.000Z",{"id":72,"name":73,"slug":74,"description":73,"sortOrder":75,"createdAt":76,"updatedAt":8,"postCount":49},"6b9179c3-17b2-43ff-a431-a03d6eb32d89","Vue2 生态","vue2-生态",10,"2022-07-16T13:14:29.000Z",{"id":78,"name":79,"slug":80,"description":79,"sortOrder":81,"createdAt":82,"updatedAt":8,"postCount":49},"73a5f62c-3c47-45b9-9ae2-f29953ae8dc0","Node","node",11,"2022-07-16T13:15:39.000Z",{"id":84,"name":85,"slug":85,"description":85,"sortOrder":86,"createdAt":87,"updatedAt":8,"postCount":29},"2b696c16-48ef-403b-a88b-6e57cfc79596","开发问题",12,"2022-07-16T14:06:54.000Z",{"id":89,"name":90,"slug":90,"description":90,"sortOrder":37,"createdAt":91,"updatedAt":8,"postCount":18},"c0f0561e-a47a-4ecd-8caa-cc1df2315d57","算法","2022-07-16T14:22:34.000Z",{"id":93,"name":94,"slug":95,"description":94,"sortOrder":96,"createdAt":97,"updatedAt":8,"postCount":35},"a629c1f7-29f1-439e-be3c-29670b17ba20","Vue2","vue2",15,"2022-07-16T14:41:51.000Z",[99,105,110,113,118,123,127,131,136,141,146,151,154,159,163,167,172,177,182,187,191,195,199,201,205,210,215,218,221,224,227,230,234,237,239,241,244,248,251,255,259,262,265,267,270,272,273,276],{"id":100,"name":101,"slug":102,"createdAt":103,"updatedAt":104},"076bd8b9-293e-45cb-9dc3-e162007ca474","Axios","axios","2022-06-05T07:41:56.000Z","2025-12-30T07:26:21.000Z",{"id":106,"name":107,"slug":108,"createdAt":109,"updatedAt":8},"2aa7f6d0-1fac-4ed1-b9bb-f3afc813f42c","Axure","axure","2022-06-21T03:35:15.000Z",{"id":111,"name":27,"slug":28,"createdAt":112,"updatedAt":8},"b084ddd8-09be-4e57-98f0-cf4e376aecd7","2022-05-21T09:59:55.000Z",{"id":114,"name":115,"slug":116,"createdAt":117,"updatedAt":8},"78a62bff-ff77-4878-8c25-3e6aae18c668","Docker","docker","2022-07-16T14:34:37.000Z",{"id":119,"name":120,"slug":121,"createdAt":122,"updatedAt":8},"2de16806-ef3f-4e54-a259-d1e1e182468c","Git","git","2022-07-16T14:25:15.000Z",{"id":124,"name":125,"slug":126,"createdAt":112,"updatedAt":8},"994cc226-578b-4a72-a57e-a47a63d2793e","JavaScript生态","javascript生态",{"id":128,"name":129,"slug":130,"createdAt":112,"updatedAt":8},"5086e93c-23b9-43d3-9643-cc87f0e9ee94","JenKins","jenkins",{"id":132,"name":133,"slug":134,"createdAt":135,"updatedAt":8},"b73007a8-bb5c-42a8-9fd9-163033a5b45d","Linux","linux","2022-07-16T14:40:17.000Z",{"id":137,"name":138,"slug":139,"createdAt":140,"updatedAt":8},"0b658b92-dd6b-4db3-a398-9f6d69950a02","Markdown","markdown","2022-07-16T14:39:25.000Z",{"id":142,"name":143,"slug":144,"createdAt":145,"updatedAt":8},"ab034d3a-6e5b-4db5-a2dc-faf4ccbb63f5","Nest","nest","2022-07-16T13:15:49.000Z",{"id":147,"name":148,"slug":149,"createdAt":150,"updatedAt":8},"52c41978-da06-4962-9636-45bbaeedda80","Nginx","nginx","2022-05-21T09:59:56.000Z",{"id":152,"name":153,"slug":153,"createdAt":150,"updatedAt":8},"0f1cc678-40e4-44b1-b2cf-a6fd8a1c867a","npm",{"id":155,"name":156,"slug":157,"createdAt":158,"updatedAt":8},"a4370d78-70e1-4073-a8f6-3dc5d81fd8fd","Nuxt","nuxt","2022-06-01T13:07:07.000Z",{"id":160,"name":161,"slug":162,"createdAt":112,"updatedAt":8},"d232e01f-048e-4151-8a0a-fff9561f946f","Pinia","pinia",{"id":164,"name":165,"slug":166,"createdAt":150,"updatedAt":8},"14e9ab02-b0bb-4c85-8604-fe6f1f0f33cd","Pnpm","pnpm",{"id":168,"name":169,"slug":170,"createdAt":171,"updatedAt":171},"399d1d38-cc0d-43ce-8baf-c769447a2ebd","React生态","react生态","2023-02-21T02:03:09.000Z",{"id":173,"name":174,"slug":175,"createdAt":176,"updatedAt":8},"c95bbe84-bdd0-410a-86a9-e87958c55f4f","Redis","redis","2022-10-05T05:14:14.000Z",{"id":178,"name":179,"slug":180,"createdAt":181,"updatedAt":8},"6d05f9df-e116-450f-af57-85ed710c4870","Swiper","swiper","2022-06-01T14:08:46.000Z",{"id":183,"name":184,"slug":185,"createdAt":186,"updatedAt":8},"66f3aeb0-84ef-45f6-a43a-944eefc9895a","Vite","vite","2022-06-02T07:28:24.000Z",{"id":188,"name":189,"slug":190,"createdAt":112,"updatedAt":8},"bf5b94d3-090b-4098-a03c-4bc69781fb2d","Vue","vue",{"id":192,"name":193,"slug":194,"createdAt":150,"updatedAt":8},"2f7fb1be-b9c5-4606-b54f-e9f66f2653b2","Vue-Router","vue-router",{"id":196,"name":197,"slug":198,"createdAt":112,"updatedAt":8},"2fef3b91-1c1c-4ae8-b2c1-0e04b4f9b3a2","Vue2生态","vue2生态",{"id":200,"name":40,"slug":41,"createdAt":112,"updatedAt":8},"62b94c93-724f-488d-8fc5-0449971d9204",{"id":202,"name":203,"slug":204,"createdAt":112,"updatedAt":8},"20bff9cd-7848-4c16-8775-42cf12b44b30","Vue3生态","vue3生态",{"id":206,"name":207,"slug":208,"createdAt":209,"updatedAt":8},"c807b2c6-cb12-4409-a1f1-6bea9f330a6b","Vuex","vuex","2022-07-16T13:14:59.000Z",{"id":211,"name":212,"slug":213,"createdAt":214,"updatedAt":8},"5782dff5-2ea2-4427-9696-d4363a7fd5bc","Webpack","webpack","2022-07-16T14:33:41.000Z",{"id":216,"name":217,"slug":217,"createdAt":112,"updatedAt":8},"d0aa41f4-68f8-48d4-a4ed-3a503ea90451","下载",{"id":219,"name":220,"slug":220,"createdAt":112,"updatedAt":8},"a046060c-39ef-474a-8c85-2546aca0e2e5","代码片段",{"id":222,"name":223,"slug":223,"createdAt":112,"updatedAt":8},"fee73435-b2be-4b55-85b1-d133ea96aea4","伪元素",{"id":225,"name":226,"slug":226,"createdAt":112,"updatedAt":8},"436bd369-8c57-4869-8827-e88e50e5e0ab","伪类",{"id":228,"name":229,"slug":229,"createdAt":112,"updatedAt":8},"4c6be544-8a00-4445-92a3-e3dcbaf6142e","动画",{"id":231,"name":232,"slug":232,"createdAt":233,"updatedAt":8},"9321a12e-ea72-49a9-a32d-5566149f812f","图片压缩","2022-08-02T00:37:47.000Z",{"id":235,"name":236,"slug":236,"createdAt":150,"updatedAt":8},"512b16fb-576a-4397-a7c5-dd20e6a8f9ca","布局",{"id":238,"name":69,"slug":69,"createdAt":112,"updatedAt":8},"f32faa96-f2ec-45c6-9a17-2c76062edcb0",{"id":240,"name":34,"slug":34,"createdAt":112,"updatedAt":8},"3c46ed3f-6d6b-4f91-bcb3-af5112860bf5",{"id":242,"name":243,"slug":243,"createdAt":112,"updatedAt":8},"dbfc086a-73a6-4560-814d-593acb61cf98","性能优化",{"id":245,"name":246,"slug":246,"createdAt":247,"updatedAt":8},"1831cd06-0d6b-48f7-94fa-324782fe23cb","拖拽","2022-07-28T12:39:13.000Z",{"id":249,"name":250,"slug":250,"createdAt":150,"updatedAt":8},"9a74300d-06f7-46d0-80d9-8fe67ec0539b","数组",{"id":252,"name":253,"slug":253,"createdAt":254,"updatedAt":8},"19ac8998-7e0a-459b-9702-bb1adca70e8c","文本复制","2022-07-17T01:54:45.000Z",{"id":256,"name":257,"slug":257,"createdAt":258,"updatedAt":8},"5ff33473-71a4-4e02-8c82-f9ea369a768f","时间","2022-07-17T01:51:12.000Z",{"id":260,"name":261,"slug":261,"createdAt":112,"updatedAt":8},"aa47ca4d-d3f6-4cac-b495-2c67c9592c36","最新优惠",{"id":263,"name":264,"slug":264,"createdAt":150,"updatedAt":8},"f6766d54-54fc-405e-932d-b7d550559125","服务器",{"id":266,"name":65,"slug":65,"createdAt":112,"updatedAt":8},"d856559a-03ff-40b4-980d-3f272b998c3c",{"id":268,"name":269,"slug":269,"createdAt":112,"updatedAt":8},"692d5d68-b188-4e5c-aca8-65d0229399a1","渐变",{"id":271,"name":90,"slug":90,"createdAt":112,"updatedAt":8},"38e1fd6b-d7c6-4d62-bf70-7bacc175bea9",{"id":5,"name":6,"slug":6,"createdAt":7,"updatedAt":8},{"id":274,"name":275,"slug":275,"createdAt":150,"updatedAt":8},"b42e2916-ad62-4b8a-a863-cd8c19a829de","面试",{"id":277,"name":278,"slug":278,"createdAt":150,"updatedAt":8},"7069add9-b636-44f1-9cd4-ea3a6d2b85d3","面试题",104,48,[282,299,311,324,337],{"id":283,"title":284,"slug":284,"content":285,"excerpt":284,"coverImage":286,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":290,"publishedAt":291,"createdAt":291,"updatedAt":292,"category":293,"author":294,"tags":297},"a1bd1f49-6f6d-4fea-9789-b5636e19a6b3","uni-app瀑布流","## 实现思路\n> 获取父组件的列表数组，watch监听数组长度变化，截取后面新的数据，创建两个左右数组，比较左右dom的长度，哪个短，就push一条数据进去，源数组删除一条数据。利用img的load（加载成功）和error方法（加载失败），触发数组的push，实现瀑布流\n\n## 代码实现\n\n```language\n\u003Ctemplate>\n    \u003Cview class=\\\"waterfall\\\">\n        \u003Cview class=\\\"waterfall_left\\\">\n            \u003Cview class=\\\"waterfall_list\\\" v-for=\\\"(item, index) in leftList\\\" :key=\\\"index\\\">\n                \u003CSearch\n                    :name=\\\"item.name\\\"\n                    :image=\\\"item.src\\\"\n                    :label=\\\"item.label\\\"\n                    :item=\\\"item\\\"\n                    @considerPush=\\\"considerPush\\\"\n                >\n                \u003C\u002FSearch>\n            \u003C\u002Fview>\n        \u003C\u002Fview>\n        \u003Cview class=\\\"waterfall_right\\\">\n            \u003Cview class=\\\"waterfall_list\\\" v-for=\\\"(item, index) in rightList\\\" :key=\\\"index\\\">\n                \u003CSearch\n                    :name=\\\"item.name\\\"\n                    :image=\\\"item.src\\\"\n                    :label=\\\"item.label\\\"\n                    :item=\\\"item\\\"\n                    @considerPush=\\\"considerPush\\\"\n                >\n                \u003C\u002FSearch>\n            \u003C\u002Fview>\n        \u003C\u002Fview>\n    \u003C\u002Fview>\n\u003C\u002Ftemplate>\n\n\u003Cscript>\nimport Search from '@\u002Fcomponents\u002Fsearch\u002Fsearch.vue';\nexport default {\n    components: { Search },\n    props: {\n        list: {\n            type: Array,\n            default: () => []\n        }\n    },\n    data() {\n        return {\n            \u002F\u002F 左侧列表\n            leftList: [],\n            \u002F\u002F 右侧列表\n            rightList: [],\n            \u002F\u002F 组件数据备份\n            newList: [],\n            \u002F\u002F默认请求数,主要为了正常排序\n            interceptNumber: 10\n        };\n    },\n    created() {\n        this.touchOff(); \u002F\u002F 触发排列\n    },\n    mounted() {},\n    watch: {\n        list(newValue, oldValue) {\n            this.interceptNumber = newValue.length - oldValue.length;\n            this.touchOff();\n        }\n    },\n    computed: {},\n    methods: {\n        \u002F\u002F 触发重新排列\n        touchOff() {\n            this.newList = [...this.list.slice(-this.interceptNumber)];\n            if (this.newList.length !== 0) {\n                this.leftList.push(this.newList.shift()); \u002F\u002F触发排列\n            }\n        },\n        \u002F\u002F 计算排列\n        considerPush() {\n            this.$nextTick(() => {\n                if (this.newList.length == 0) return; \u002F\u002F没有数据了\n                let leftH = 0;\n                let rightH = 0; \u002F\u002F左右高度\n                let query = uni.createSelectorQuery().in(this);\n                query.selectAll('.waterfall_left').boundingClientRect();\n                query.selectAll('.waterfall_right').boundingClientRect();\n                query.exec(res => {\n                    leftH = res[0].length != 0 ? res[0][0].height : 0; \u002F\u002F防止查询不到做个处理\n                    rightH = res[1].length != 0 ? res[1][0].height : 0;\n                    if (leftH == rightH || leftH \u003C rightH) {\n                        \u002F\u002F 相等 || 左边小\n                        this.leftList.push(this.newList.shift());\n                    } else {\n                        \u002F\u002F 右边小\n                        this.rightList.push(this.newList.shift());\n                    }\n\n                    \u002F\u002F console.log('左右高度：', leftH, rightH, leftH == rightH || leftH \u003C rightH);\n                });\n            });\n        }\n    }\n};\n\u003C\u002Fscript>\n\n\u003Cstyle scoped lang=\\\"scss\\\">\n.waterfall {\n    display: flex;\n    align-items: flex-start;\n    justify-content: flex-start;\n    .waterfall_left {\n        flex: 1;\n    }\n\n    .waterfall_right {\n        flex: 1;\n    }\n}\n\u003C\u002Fstyle>\n\n```\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F7d4fa8d1d2775177b882a4656e3a5ed5.png","PUBLISHED",false,null,1817,"2022-11-22T07:54:41.000Z","2026-06-26T10:25:05.932Z",{"id":46,"name":47,"slug":48},{"id":295,"name":296,"avatar":289},"f9d0f2de-c700-4f90-b535-afd3dbe78128","Admin",[298],{"id":124,"name":125,"slug":126},{"id":300,"title":301,"slug":301,"content":302,"excerpt":301,"coverImage":303,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":304,"publishedAt":305,"createdAt":305,"updatedAt":306,"category":307,"author":308,"tags":309},"b2c46bf6-d971-4cce-b21b-052dbea8e8a2","v-html使用img点击实现放大效果","## 代码实现\n```js\n\u002F**\n * JS获取html代码中所有的图片地址\n * @param htmlstr\n * @returns arr 数组\n *\u002F\n\nexport function getimgsrc(htmlstr) {\n    let reg = \u002F\u003Cimg.+?src=('|\\\")?([^'\\\"]+)('|\\\")?(?:\\s+|>)\u002Fg;\n    let arr = [];\n    let tem = 0;\n    \u002F\u002Feslint-disable-next-line\n    while ((tem = reg.exec(htmlstr))) {\n        arr.push(tem[2]); \u002F\u002F eslint-disable-line\n    }\n\n    return arr;\n}\n\n```\n\n\n\n```vue\n\u003Ctemplate>\n    \u003Cdiv class=\\\"image-expansion\\\" :class=\\\"classArr\\\">\n        \u003Cdiv @click.stop=\\\"hanldeImage($event)\\\" v-html=\\\"formatHtmlData\\\">\u003C\u002Fdiv>\n\n        \u003Cel-image-viewer\n            v-if=\\\"imgPreviewUrl\\\"\n            :initial-index=\\\"subscript\\\"\n            :src=\\\"imgPreviewUrl\\\"\n            :on-close=\\\"closeViewer\\\"\n            :url-list=\\\"imgList\\\"\n        >\u003C\u002Fel-image-viewer>\n    \u003C\u002Fdiv>\n\u003C\u002Ftemplate>\n\n\u003Cscript>\nimport { getimgsrc } from '..\u002F..\u002Futils\u002Fgetimgsrc';\nimport ElImageViewer from 'element-ui\u002Fpackages\u002Fimage\u002Fsrc\u002Fimage-viewer';\nexport default {\n    components: {\n        ElImageViewer\n    },\n    props: {\n        htmlData: {\n            type: String,\n            default: () => {\n                return '';\n            }\n        },\n        classArr: {\n            type: Array,\n            default: () => {\n                return ['min'];\n            }\n        },\n\n        isArticle: {\n            type: Boolean,\n            default: () => {\n                return false;\n            }\n        }\n    },\n    data() {\n        return {\n            imgList: [],\n            formatHtmlData: '',\n            imgPreviewUrl: '',\n            subscript: 0\n        };\n    },\n    computed: {},\n\n    watch: {\n        \u002F\u002F监听数据，防止数据不更新\n        htmlData: {\n            handler(newName, oldName) {\n                \u002F\u002F判断是否为文章\n                if (this.isArticle) {\n                    newName ? (this.formatHtmlData = newName.replace(\u002F(\u003C([^>]+)>)\u002Fgi, '').replace(\u002F[\\\r\\\n]\u002Fg, '')) : '';\n                } else {\n                    \u002F\u002F剔除strong和p标签\n                    newName ? (this.formatHtmlData = newName.replace(\u002F(\u003C\\\u002F?strong.*?>)|(\u003C\\\u002F?p.*?>)\u002Fg, '')) : '';\n\n                    \u002F\u002F获取html全部图片，push成图片数组\n                    this.imgList = Object.values(getimgsrc(this.formatHtmlData));\n                    \u002F\u002F获取图片下标\n                    let subscript = this.imgList.indexOf(this.imgPreviewUrl);\n                    this.subscript = subscript > -1 ? subscript : 0;\n                }\n            },\n\n            immediate: true\n        }\n    },\n\n    mounted() {},\n\n    methods: {\n        \u002F\u002F监听点击事件\n        hanldeImage(event) {\n            if (event.target.nodeName === 'IMG' || event.target.nodeName === 'img') {\n                \u002F\u002F获取点击的图片url,decodeURIComponent转码一下，防禁url转码\n                this.imgPreviewUrl = decodeURIComponent(event.target.currentSrc);\n\n                \u002F\u002F获取图片下标\n                let subscript = this.imgList.indexOf(this.imgPreviewUrl);\n                this.subscript = subscript > -1 ? subscript : 0;\n\n                \u002F\u002F禁止遮罩层后面的内容滚动\n                document.documentElement.style.overflowY = 'hidden';\n            } else {\n                this.$emit('goDetail');\n            }\n        },\n\n        \u002F\u002F关闭弹框\n        closeViewer() {\n            this.imgPreviewUrl = '';\n            \u002F\u002F恢复遮罩层后面的内容滚动\n            document.documentElement.style.overflowY = 'auto';\n        }\n    }\n};\n\u003C\u002Fscript>\n\n\u003Cstyle lang=\\\"scss\\\" scoped>\n.image-expansion {\n}\n\n.min {\n    \u002Fdeep\u002F img {\n        cursor: pointer;\n        height: 28px;\n        padding: 0 10px 3px;\n    }\n}\n\n.max {\n    \u002Fdeep\u002F img {\n        cursor: pointer;\n    }\n}\n\n.class1 {\n    \u002Fdeep\u002F div {\n        font-size: 15px;\n        font-family: Microsoft YaHei;\n        font-weight: 400;\n        color: #888888;\n        line-height: 30px;\n    }\n}\n\u003C\u002Fstyle>\n\n\n```\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002Fc77c3fb113d1ab2f67e7afba1ca33b95.png",1571,"2023-01-10T07:22:29.000Z","2026-06-26T10:25:07.650Z",{"id":72,"name":73,"slug":74},{"id":295,"name":296,"avatar":289},[310],{"id":231,"name":232,"slug":232},{"id":312,"title":313,"slug":314,"content":315,"excerpt":313,"coverImage":316,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":317,"publishedAt":318,"createdAt":318,"updatedAt":319,"category":320,"author":321,"tags":322},"9f33b49b-0785-4404-9a4e-d85937e7fc92","在 vue3 中优雅的使用 jsx\u002Ftsx","在-vue3-中优雅的使用-jsx-tsx","## 安装插件（@vitejs\u002Fplugin-vue-jsx）\n```shell\npnpm add @vitejs\u002Fplugin-vue-jsx -D\n```\n\n## 配置vite.config.ts\n```ts\nimport vueJsx from \\\"@vitejs\u002Fplugin-vue-jsx\\\";\n\nexport default defineConfig({\n  plugins: [\n    vueJsx(),\n  ]\n})\n```\n\n## 插值\n```language\n\u002F\u002F vue3模板语法\n\u003Cspan>{{ a + b }}\u003C\u002Fspan>\n\n\u002F\u002F jsx\u002Ftsx\n\u003Cspan>{ a + b }\u003C\u002Fspan>\n```\n\n\n## class与style 绑定\n\n```ts\n\u002F\u002F 模板字符串\n\u003Cdiv className={`header ${ isBg ? 'headerBg' : '' }`}>header\u003C\u002Fdiv>\n\u002F\u002F数组\n\u003Cdiv class={ [ 'header', isBg && 'headerBg' ] } >header\u003C\u002Fdiv>\n```\n\n```ts\nconst color = 'red'\nconst element = \u003Csapn style={{ color, fontSize: '16px' }}>style\u003C\u002Fsapn>\n```\n\n## 条件渲染\n\n```ts\n   setup() {\n       const isShow = false\n       const element = () => {\n           if (isShow) {\n               return \u003Cspan>我是if\u003C\u002Fspan>\n           } else {\n               return \u003Cspan>我是else\u003C\u002Fspan>\n           }\n       }\n       return () => (\n           \u003Cdiv>\n               \u003Cspan v-show={isShow}>我是v-show\u003C\u002Fspan>\n               {\n                   element()\n               }\n               {\n                   isShow ? \u003Cp>我是三目1\u003C\u002Fp> : \u003Cp>我是三目2\u003C\u002Fp>\n               }\n           \u003Cdiv>\n       )\n   }\n```\n\n## 列表渲染\n```language\nsetup() {\n   const listData = [\n       {name: 'Tom', age: 18},\n       {name: 'Jim', age: 20},\n       {name: 'Lucy', age: 16}\n   ]\n   return () => (\n       \u003Cdiv>\n           \u003Cdiv class={'box'}>\n               \u003Cspan>姓名\u003C\u002Fspan>\n               \u003Cspan>年龄\u003C\u002Fspan>\n           \u003C\u002Fdiv>\n           {\n               prop.listData.map(item => {\n                   return \u003Cdiv class={'box'}>\n                       \u003Cspan>{item.name}\u003C\u002Fspan>\n                       \u003Cspan>{item.age}\u003C\u002Fspan>\n                   \u003C\u002Fdiv>\n               })\n           }\n       \u003C\u002Fdiv>\n   )\n}\n\n```\n\n## 事件处理\n\n```language\nsetup() {\n    const clickBox = val => {\n        console.log(val)\n    }\n    return () => (\n        \u003Cdiv class={'box1'} onClick={() => clickBox('box1')}>\n            \u003Cspan>我是box1\u003C\u002Fspan>\n            \u003Cdiv class={'box2'} onClick={() => clickBox('box2')}>\n                \u003Cspan>我是box2\u003C\u002Fspan>\n                \u003Cdiv class={'box3'} onClick={withModifiers(() => clickBox('box3'), ['stop'])}>我是box3\u003C\u002Fdiv>\n            \u003C\u002Fdiv>\n        \u003C\u002Fdiv>\n    )\n}\n```\n\n## v-model\n\n```ts\n\u002F\u002F 正常写法\n\u003Cinput v-model=\\\"value\\\" \u002F> \u002F\u002F vue\n\u003Cinput v-model={value} \u002F> \u002F\u002F jsx\n\n\u002F\u002F 指定绑定值写法\n\u003Cinput v-model:modelValue=\\\"value\\\" \u002F> \u002F\u002F vue\n\u003Cinput v-model={[value,'modelValue']} \u002F> \u002F\u002F jsx\n\n\u002F\u002F 修饰符写法\n\u003Cinput v-model:modelValue.trim=\\\"value\\\" \u002F> \u002F\u002F vue\n\u003Cinput v-model={[value,'modelValue',['trim']]} \u002F> \u002F\u002F jsx\n```\n\n## slot插槽\n\n### 定义插槽\n```ts\nimport { renderSlot } from \\\"vue\\\"\nexport default defineComponent({\n    \u002F\u002F 从ctx中解构出来 slots\n    setup(props, { slots }) {\n        return () => (\n            \u003Cdiv>\n                { renderSlot(slots, 'default') }\n                { slots.title?.() }\n            \u003C\u002Fdiv>\n        )\n    }\n})\n\n```\n\n### 使用插槽\n\n```ts\nimport Vslot from '.\u002FslotTem'\nexport default defineComponent({\n    setup() {\n        return () => (\n            \u003Cdiv class={'box'}>\n                \u003CVslot v-slots={{\n                    title: () => {\n                        return \u003Cp>我是title插槽\u003C\u002Fp>\n                    },\n                    default: () => {\n                        return \u003Cp>我是default插槽\u003C\u002Fp>\n                    }\n                }} \u002F>\n            \u003C\u002Fdiv>\n        )\n    }\n})\n\n```\n\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F3e4cb0d3df611ee3f57b8ed503e1015e.png",1391,"2023-04-19T09:23:27.000Z","2026-06-26T09:54:47.369Z",{"id":39,"name":40,"slug":41},{"id":295,"name":296,"avatar":289},[323],{"id":200,"name":40,"slug":41},{"id":325,"title":326,"slug":327,"content":328,"excerpt":326,"coverImage":329,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":330,"publishedAt":331,"createdAt":331,"updatedAt":332,"category":333,"author":334,"tags":335},"1dcdd755-0e46-45a3-8998-9a213fd3fcd5","Vue3 导入导出Excel","vue3-导入导出excel","## 安装\n```shell\npnpm add -S XLSX\n```\n\n\n## 方法封装\n```js\nimport * as XLSX from 'xlsx';\n\n\u002F\u002F参数说明\n\u002F\u002Fconfiguration: {\n\u002F\u002F  data: [], \u002F\u002F 导出的数据\n\u002F\u002F  head: {}, \u002F\u002F 导出的数据对应的表头\n\u002F\u002F  name: '', \u002F\u002F 导出的文件名\n\u002F\u002F  label: '', \u002F\u002F 导出的表单名\n\u002F\u002F  widthArr: [], \u002F\u002F 导出的表单列宽\n\u002F\u002F}\n\n\u002F\u002F 导出excel\nexport const ExportXlsx = (configuration) => {\n  const { data, head, name, label, widthArr } = configuration;\n\n  const list = data.map((item) => {\n    const obj = {};\n    for (const k in item) {\n      if (head[k]) {\n        obj[head[k]] = item[k];\n      }\n    }\n    return obj;\n  });\n\n  \u002F\u002F 创建工作表\n  const xLSXData = XLSX.utils.json_to_sheet(list);\n  \u002F\u002F 创建工作簿\n  const wb = XLSX.utils.book_new();\n  \u002F\u002F 将工作表放入工作簿中\n  XLSX.utils.book_append_sheet(wb, xLSXData, label);\n  xLSXData['!cols'] = [];\n  \u002F\u002F 设置列宽\n  widthArr.forEach((item) => {\n    xLSXData['!cols'].push({ wpx: item });\n  });\n\n  \u002F\u002F 生成文件并下载\n  XLSX.writeFile(wb, `${name}.xlsx`);\n};\n\n\u002F\u002F 导入excel\nexport const ImportXlsx = (e) => {\n  const file = e.target.files[0];\n  const reader = new FileReader();\n  reader.readAsArrayBuffer(file);\n  reader.onload = (e) => {\n    const data = e.target.result;\n    const workbook = XLSX.read(data, { type: 'binary', cellDates: true });\n    const wsname = workbook.SheetNames[0];\n    const outdata = XLSX.utils.sheet_to_json(workbook.Sheets[wsname]);\n    console.log(outdata);\n  };\n};\n\n```\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F80231a326d3846b895a7d46c99e738ce.png",1334,"2023-03-14T06:18:59.000Z","2026-06-26T09:54:47.798Z",{"id":46,"name":47,"slug":48},{"id":295,"name":296,"avatar":289},[336],{"id":124,"name":125,"slug":126},{"id":338,"title":339,"slug":340,"content":341,"excerpt":339,"coverImage":342,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":343,"publishedAt":344,"createdAt":344,"updatedAt":345,"category":346,"author":350,"tags":351},"80920598-a452-4357-bf53-842b200560e8","React18入门到精通教程","react18入门到精通教程","\n## JSX实现列表渲染\n> 使用`map()`方法遍历数组，必须添加`key`属性提高性能\n```jsx\nconst songs = [\n  { id: 1, name: \\\"helo1\\\" },\n  { id: 2, name: \\\"helo2\\\" },\n  { id: 3, name: \\\"helo3\\\" },\n];\n\nfunction App() {\n  return (\n    \u003Cdiv>\n      \u003Cul>\n        {songs.map((song) => (\n          \u002F\u002F 关键：添加唯一key标识符（避免使用索引）\n          \u003Cli key={song.id}>  \n            {song.id}-{song.name}\n          \u003C\u002Fli>\n        ))}\n      \u003C\u002Ful>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n**最佳实践：**\n1. 使用`\u003Cul>`包裹列表项\n2. `key`应使用稳定唯一标识（如ID），避免数组索引\n3. 空列表处理：`{songs.length > 0 && ...}` 或 `{songs.map(...) || \u003CEmptyView\u002F>}`\n\n## JSX实现条件渲染\n### 简单逻辑\n```jsx\n\u002F\u002F 三元表达式\n{isLoggedIn ? \u003CDashboard \u002F> : \u003CLoginForm \u002F>}\n\n\u002F\u002F 逻辑短路\n{hasNotification && \u003CNotificationBadge count={5} \u002F>}\n\n\u002F\u002F 空值处理\n{userProfile?.avatar || \u003CDefaultAvatar \u002F>}\n```\n\n### 复杂逻辑\n```jsx\nconst renderContent = (type) => {\n  switch(type) {\n    case 'success': \n      return \u003CSuccessAlert \u002F>;\n    case 'error':\n      return \u003CErrorAlert \u002F>;\n    default:\n      return \u003CInfoAlert \u002F>;\n  }\n}\n\nfunction App() {\n  return (\n    \u003Cdiv className=\\\"container\\\">\n      {renderContent(status)}\n      \n      {\u002F* 另一种模式：立即执行函数 *\u002F}\n      {(() => {\n        if (isLoading) return \u003CSpinner \u002F>;\n        if (isEmpty) return \u003CEmptyState \u002F>;\n        return \u003CDataTable \u002F>;\n      })()}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## JSX样式处理\n### 行内样式\n```jsx\n\u002F\u002F 直接对象\n\u003Cdiv style={{ \n  color: 'white', \n  backgroundColor: 'teal',\n  padding: '1rem'\n}}>\n\n\u002F\u002F 样式对象复用\nconst alertStyle = {\n  padding: '15px',\n  borderRadius: '4px',\n  margin: '10px 0'\n};\n\nfunction Alert({ type }) {\n  return (\n    \u003Cdiv style={{\n      ...alertStyle,  \u002F\u002F 扩展运算符合并样式\n      background: type === 'error' ? '#f8d7da' : '#d4edda'\n    }}>\n      {message}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### 类名控制（推荐）\n```css\n\u002F* styles.module.css *\u002F\n.card {\n  border: 1px solid #ddd;\n  border-radius: 8px;\n  padding: 20px;\n  box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n}\n\n.highlight {\n  background-color: #ffffe0;\n}\n```\n\n```jsx\nimport styles from '.\u002Fstyles.module.css';\n\nfunction ProductCard({ featured }) {\n  return (\n    \u003Cdiv className={`${styles.card} ${featured ? styles.highlight : ''}`}>\n      {\u002F* 内容 *\u002F}\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n## React 18新特性\n### 并发模式（Concurrent Mode）\n```jsx\nimport { startTransition } from 'react';\n\n\u002F\u002F 非紧急状态更新\nfunction handleSearch(query) {\n  startTransition(() => {\n    setSearchQuery(query); \u002F\u002F 可中断的渲染\n  });\n}\n```\n\n### 自动批处理（Automatic Batching）\n```jsx\n\u002F\u002F React 17及之前：两次渲染\n\u002F\u002F React 18：自动批处理，一次渲染\nfunction handleClick() {\n  setCount(c => c + 1);\n  setFlag(f => !f);\n}\n```\n\n## Redux状态管理（现代写法）\n### 安装依赖\n```bash\nnpm install @reduxjs\u002Ftoolkit react-redux\n```\n\n### 创建Store\n```js\n\u002F\u002F store.js\nimport { configureStore, createSlice } from '@reduxjs\u002Ftoolkit';\n\nconst counterSlice = createSlice({\n  name: 'counter',\n  initialState: { value: 0 },\n  reducers: {\n    increment: state => { state.value += 1 },\n    decrement: state => { state.value -= 1 },\n    incrementByAmount: (state, action) => {\n      state.value += action.payload\n    }\n  }\n});\n\n\u002F\u002F 异步操作示例\nexport const fetchUserData = () => async (dispatch) => {\n  const response = await fetch('\u002Fapi\u002Fuser');\n  dispatch(setUser(await response.json()));\n};\n\nexport const store = configureStore({\n  reducer: {\n    counter: counterSlice.reducer,\n    \u002F\u002F 其他reducer...\n  }\n});\n\nexport const { increment, decrement } = counterSlice.actions;\n```\n\n### 组件集成\n```jsx\n\u002F\u002F index.js\nimport { Provider } from 'react-redux';\nimport { store } from '.\u002Fstore';\n\nroot.render(\n  \u003CProvider store={store}>\n    \u003CApp \u002F>\n  \u003C\u002FProvider>\n);\n\n\u002F\u002F Counter.js\nimport { useSelector, useDispatch } from 'react-redux';\nimport { increment, decrement } from '.\u002Fstore';\n\nfunction Counter() {\n  const count = useSelector(state => state.counter.value);\n  const dispatch = useDispatch();\n\n  return (\n    \u003Cdiv>\n      \u003Cbutton onClick={() => dispatch(decrement())}>-\u003C\u002Fbutton>\n      \u003Cspan>{count}\u003C\u002Fspan>\n      \u003Cbutton onClick={() => dispatch(increment())}>+\u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n## 最佳实践总结\n1. **组件设计**：遵循单一职责原则，拆分智能组件（容器组件）和展示组件\n2. **状态管理**：\n   - 局部状态用`useState`\u002F`useReducer`\n   - 全局共享状态用Redux\n   - 避免过度使用状态提升\n3. **性能优化**：\n   - 使用`React.memo`记忆组件\n   - 使用`useCallback`\u002F`useMemo`避免不必要的重渲染\n   - 虚拟化长列表（react-window）\n4. **Hooks规范**：\n   - 避免在循环\u002F条件中使用Hook\n   - 自定义Hook以`use`前缀命名\n5. **TypeScript集成**：\n   ```tsx\n   interface UserCardProps {\n     name: string;\n     age: number;\n     onSelect: (id: string) => void;\n   }\n   \n   const UserCard: React.FC\u003CUserCardProps> = ({ name, age }) => (\n     \u003Cdiv>{name} ({age})\u003C\u002Fdiv>\n   )\n   ```\n\n下面为您完善教程，增加React路由和生命周期相关内容：\n\n## React路由管理（React Router v6）\n\n### 安装与基础配置\n```bash\nnpm install react-router-dom@6\n```\n\n### 路由基础结构\n```jsx\n\u002F\u002F index.js\nimport { BrowserRouter } from 'react-router-dom';\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\nroot.render(\n  \u003CBrowserRouter>\n    \u003CApp \u002F>\n  \u003C\u002FBrowserRouter>\n);\n\n\u002F\u002F App.js\nimport { Routes, Route, Link } from 'react-router-dom';\n\nfunction App() {\n  return (\n    \u003Cdiv>\n      \u003Cnav>\n        \u003CLink to=\\\"\u002F\\\">首页\u003C\u002FLink>\n        \u003CLink to=\\\"\u002Fabout\\\">关于\u003C\u002FLink>\n        \u003CLink to=\\\"\u002Fusers\\\">用户列表\u003C\u002FLink>\n      \u003C\u002Fnav>\n      \n      \u003CRoutes>\n        \u003CRoute path=\\\"\u002F\\\" element={\u003CHome \u002F>} \u002F>\n        \u003CRoute path=\\\"\u002Fabout\\\" element={\u003CAbout \u002F>} \u002F>\n        \u003CRoute path=\\\"\u002Fusers\\\" element={\u003CUserList \u002F>} \u002F>\n        \u003CRoute path=\\\"\u002Fusers\u002F:id\\\" element={\u003CUserDetail \u002F>} \u002F>\n        \u003CRoute path=\\\"*\\\" element={\u003CNotFound \u002F>} \u002F>\n      \u003C\u002FRoutes>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n### 嵌套路由\n```jsx\n\u002F\u002F Dashboard.js\nimport { Outlet } from 'react-router-dom';\n\nfunction Dashboard() {\n  return (\n    \u003Cdiv>\n      \u003Ch2>仪表盘\u003C\u002Fh2>\n      \u003COutlet \u002F> {\u002F* 子路由渲染位置 *\u002F}\n    \u003C\u002Fdiv>\n  );\n}\n\n\u002F\u002F 路由配置\n\u003CRoutes>\n  \u003CRoute path=\\\"\u002Fdashboard\\\" element={\u003CDashboard \u002F>}>\n    \u003CRoute index element={\u003CDashboardHome \u002F>} \u002F>\n    \u003CRoute path=\\\"settings\\\" element={\u003CDashboardSettings \u002F>} \u002F>\n    \u003CRoute path=\\\"analytics\\\" element={\u003CDashboardAnalytics \u002F>} \u002F>\n  \u003C\u002FRoute>\n\u003C\u002FRoutes>\n```\n\n### 编程式导航\n```jsx\nimport { useNavigate, useParams, useLocation } from 'react-router-dom';\n\nfunction UserCard({ user }) {\n  const navigate = useNavigate();\n  \n  return (\n    \u003Cdiv onClick={() => navigate(`\u002Fusers\u002F${user.id}`)}>\n      {user.name}\n    \u003C\u002Fdiv>\n  );\n}\n\nfunction UserDetail() {\n  const { id } = useParams(); \u002F\u002F 获取URL参数\n  const location = useLocation(); \u002F\u002F 获取位置对象\n  \n  return (\n    \u003Cdiv>\n      \u003Ch2>用户ID: {id}\u003C\u002Fh2>\n      \u003Cp>当前路径: {location.pathname}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n### 路由守卫（认证保护）\n```jsx\nimport { Navigate } from 'react-router-dom';\n\nfunction ProtectedRoute({ children }) {\n  const { isAuthenticated } = useAuth();\n  \n  if (!isAuthenticated) {\n    return \u003CNavigate to=\\\"\u002Flogin\\\" replace \u002F>;\n  }\n  \n  return children;\n}\n\n\u002F\u002F 使用\n\u003CRoute \n  path=\\\"\u002Fdashboard\\\" \n  element={\n    \u003CProtectedRoute>\n      \u003CDashboard \u002F>\n    \u003C\u002FProtectedRoute>\n  } \n\u002F>\n```\n\n## React生命周期\n\n### 类组件生命周期方法\n\n```jsx\nclass LifecycleDemo extends React.Component {\n  \u002F\u002F 1. 初始化阶段\n  constructor(props) {\n    super(props);\n    this.state = { count: 0 };\n    console.log('Constructor');\n  }\n\n  \u002F\u002F 2. 挂载阶段\n  componentDidMount() {\n    console.log('Component did mount');\n    \u002F\u002F 适合进行API调用、事件订阅\n    this.timer = setInterval(() => {\n      this.setState(prev => ({ count: prev.count + 1 }));\n    }, 1000);\n  }\n\n  \u002F\u002F 3. 更新阶段\n  shouldComponentUpdate(nextProps, nextState) {\n    console.log('Should component update?');\n    return nextState.count !== this.state.count;\n  }\n\n  componentDidUpdate(prevProps, prevState) {\n    console.log('Component did update');\n  }\n\n  \u002F\u002F 4. 卸载阶段\n  componentWillUnmount() {\n    console.log('Component will unmount');\n    \u002F\u002F 清理操作\n    clearInterval(this.timer);\n  }\n\n  render() {\n    console.log('Render');\n    return \u003Cdiv>Count: {this.state.count}\u003C\u002Fdiv>;\n  }\n}\n```\n\n### 函数组件生命周期（Hooks实现）\n\n```jsx\nimport { useState, useEffect } from 'react';\n\nfunction FunctionLifecycle() {\n  const [count, setCount] = useState(0);\n  const [data, setData] = useState(null);\n\n  \u002F\u002F 相当于componentDidMount + componentDidUpdate\n  useEffect(() => {\n    console.log('每次渲染后执行');\n  });\n\n  \u002F\u002F 相当于componentDidMount\n  useEffect(() => {\n    console.log('组件挂载后执行');\n    \n    \u002F\u002F 数据获取\n    fetch('\u002Fapi\u002Fdata')\n      .then(res => res.json())\n      .then(setData);\n    \n    \u002F\u002F 相当于componentWillUnmount\n    return () => {\n      console.log('组件卸载前执行');\n    };\n  }, []); \u002F\u002F 空依赖数组\n\n  \u002F\u002F 依赖变化时执行\n  useEffect(() => {\n    console.log('count变化时执行:', count);\n    \n    document.title = `Count: ${count}`;\n    \n    return () => {\n      console.log('清理count效果');\n    };\n  }, [count]); \u002F\u002F count依赖\n\n  return (\n    \u003Cdiv>\n      \u003Cp>Count: {count}\u003C\u002Fp>\n      \u003Cbutton onClick={() => setCount(c => c + 1)}>增加\u003C\u002Fbutton>\n      {data && \u003Cpre>{JSON.stringify(data, null, 2)}\u003C\u002Fpre>}\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n### 生命周期阶段对比\n\n| 阶段 | 类组件方法 | 函数组件Hook |\n|------|------------|--------------|\n| **挂载** | constructor | useState初始化 |\n|       | render      | 函数体执行    |\n|       | componentDidMount | useEffect(() => {}, []) |\n| **更新** | shouldComponentUpdate | React.memo, useMemo |\n|       | render      | 函数体执行    |\n|       | componentDidUpdate | useEffect(() => {}) |\n| **卸载** | componentWillUnmount | useEffect返回函数 |\n| **错误处理** | componentDidCatch | 暂无直接等效，需错误边界组件 |\n\n### 现代React开发建议\n\n1. **优先使用函数组件+Hooks**：\n   - 90%的场景可替代类组件\n   - 更简洁的代码结构\n   - 更好的逻辑复用\n\n2. **关键生命周期替代**：\n   - `componentDidMount` → `useEffect(() => {}, [])`\n   - `componentDidUpdate` → `useEffect(() => {})` 或带依赖的 `useEffect`\n   - `componentWillUnmount` → `useEffect(() => { return cleanup }, [])`\n   - `shouldComponentUpdate` → `React.memo` 或 `useMemo`\n\n3. **数据获取最佳实践**：\n```jsx\nuseEffect(() => {\n  let isMounted = true;\n  \n  const fetchData = async () => {\n    try {\n      const result = await api.getData();\n      if (isMounted) setData(result);\n    } catch (error) {\n      if (isMounted) setError(error);\n    }\n  };\n  \n  fetchData();\n  \n  return () => {\n    isMounted = false; \u002F\u002F 避免组件卸载后设置状态\n  };\n}, []);\n```\n\n## 路由与生命周期整合示例\n\n```jsx\nfunction UserProfile() {\n  const { id } = useParams();\n  const [user, setUser] = useState(null);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    let isActive = true;\n    \n    const fetchUser = async () => {\n      try {\n        setLoading(true);\n        const data = await fetchUserById(id);\n        if (isActive) {\n          setUser(data);\n          setLoading(false);\n        }\n      } catch (error) {\n        if (isActive) {\n          setError(error.message);\n          setLoading(false);\n        }\n      }\n    };\n    \n    fetchUser();\n    \n    return () => {\n      isActive = false; \u002F\u002F 清理效果\n    };\n  }, [id]); \u002F\u002F id变化时重新获取\n\n  if (loading) return \u003CSpinner \u002F>;\n  \n  return (\n    \u003Cdiv>\n      \u003Ch2>{user.name}\u003C\u002Fh2>\n      \u003Cp>Email: {user.email}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\n## 完整项目结构建议\n\n```\nsrc\u002F\n├── components\u002F      # 通用UI组件\n├── pages\u002F           # 页面组件\n├── layouts\u002F         # 布局组件\n├── hooks\u002F           # 自定义Hooks\n├── store\u002F           # Redux状态\n│   ├── slices\u002F\n│   └── store.js\n├── services\u002F        # API服务\n├── routers\u002F         # 路由配置\n├── utils\u002F           # 工具函数\n├── assets\u002F          # 静态资源\n└── App.js           # 主应用组件\n```\n\n这些新增内容涵盖了React路由的现代用法（v6版本）以及React生命周期的详细解释，包括类组件和函数组件的实现方式对比。同时还提供了路由与生命周期整合的实际示例，帮助开发者理解如何在真实项目中应用这些概念。","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F46e205aa1bd33d1bb7201019fc2fdf43.png",1147,"2023-02-21T02:01:52.000Z","2026-06-26T10:25:15.418Z",{"id":347,"name":348,"slug":349},"f1701085-b8c1-413a-8750-58e7a0a33832","React","react",{"id":295,"name":296,"avatar":289},[352],{"id":168,"name":169,"slug":170},{"list":354,"total":29,"page":18,"pageSize":75},[355,368],{"id":356,"title":357,"slug":358,"content":359,"excerpt":357,"coverImage":360,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":361,"publishedAt":362,"createdAt":362,"updatedAt":363,"category":364,"author":365,"tags":366},"90ed1bf3-61f5-439b-8fdb-2f04bd311e38","RESTful API接口规范","restful-api接口规范","# RESTful规范\n\n> Restful API是目前比较成熟的一套互联网应用程序的API设计理念，Rest是一组架构约束条件和原则，如何Rest约束条件和原则的架构，我们就称为Restful架构，Restful架构具有结构清晰、符合标准、易于理解以及扩展方便等特点，受到越来越多网站的采用！\n\n##  Restful API接口规范包括以下部分：\n\n### 一、协议\n\n> API与用户的通信协议，总是使用HTTPs协议。\n\n### 二、域名\n\n> 应该尽量将API部署在专用域名之下，如https:\u002F\u002Fapi.专属域名.com；如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下，如https:\u002F\u002F专属域名.com\u002Fapi\u002F。\n\n### 三、版本\n\n> 可以将版本号放在HTTP头信息中，也可以放入URL中，如https:\u002F\u002Fapi.专属域名.com\u002Fv1\u002F\n\n### 四、路径\n\n> 路径是一种地址，在互联网上表现为网址，在RESTful架构中，每个网址代表一种资源（resource），所以网址中不能有动词，只能有名词，而且所用的名词往往与数据库的表格名对应。一般来说，数据库中的表都是同种记录的\\\"集合\\\"（collection），所以API中的名词也应该使用复数，如https:\u002F\u002Fapi.专属域名.com\u002Fv1\u002Fstudents。\n\n### 五、HTTP动词\n\n> 对于资源的具体操作类型，由HTTP动词表示，HTTP动词主要有以下几种，括号中对应的是SQL命令。\n\n| 请求方式 | 说明 |\n| - | - |\n| GET（SELECT） | 从服务器取出资源（一项或多项） |\n| POST（CREATE） | 在服务器新建一个资源 |\n| PUT（UPDATE） | 在服务器更新资源（客户端提供改变后的完整资源） |\n| PATCH（UPDATE） | 在服务器更新资源（客户端提供改变的属性） |\n| DELETE（DELETE） | 从服务器删除资源 |\n| HEAD | 获取资源的元数据； |\n| OPTIONS | 获取信息，关于资源的哪些属性是客户端可以改变的。 |\n\n\n\n## 六、过滤信息\n\n> 如果记录数量很多，服务器不可能都将它们返回给用户，API会提供参数，过滤返回结果，常见的参数有：\n\n| 传参 | 说明 |\n| - | - |\n| ?limit=20 | 指定返回记录的数量为20； |\n| ?offset=8 | 指定返回记录的开始位置为8 |\n| ?page=1&per_page=50 | 指定第1页，以及每页的记录数为50 |\n| ?sortby=name&order=asc | 指定返回结果按照name属性进行升序排序 |\n| ?animal_type_id=2 | 指定筛选条件 |\n\n\n\n## 七、状态码\n\n> 服务器会向用户返回状态码和提示信息，以下是常用的一些状态码：\n\n| 状态码 | 说明 |\n| - | - |\n| 200 OK | [GET]：服务器成功返回用户请求的数据 |\n| 201 CREATED | [POST\u002FPUT\u002FPATCH]：用户新建或修改数据成功 |\n| 201 CREATED | [POST\u002FPUT\u002FPATCH]：用户新建或修改数据成功 |\n| 202 Accepted | [*]：表示一个请求已经进入后台排队（异步任务） |\n| 204 NO CONTENT | [DELETE]：用户删除数据成功 |\n| 400 INVALID REQUEST | [*]：[POST\u002FPUT\u002FPATCH]：用户发出的请求有错误，服务器没有进行新建或修改数据的操作； |\n| 401 Unauthorized | [*]：表示用户没有权限（令牌、用户名、密码错误） |\n| 403 Forbidden | [*] 表示用户得到授权（与401错误相对），但是访问是被禁止的 |\n| 404 NOT FOUND | [*]：用户发出的请求针对的是不存在的记录，服务器没有进行操作 |\n| 406 Not Acceptable  |  [GET]：用户请求的格式不可得 |\n| 410 Gone | [GET]：用户请求的资源被永久删除，且不会再得到的 |\n| 422 Unprocesable entit | [POST\u002FPUT\u002FPATCH] 当创建一个对象时，发生一个验证错误 |\n| 500 INTERNAL SERVER ERROR | [*]：服务器发生错误，用户将无法判断发出的请求是否成功。 |\n\n\n### 八、错误处理\n\n> 如果状态码是4xx，就会向用户返回出错信息，一般来说，返回的信息中将error作为键名，出错信息作为键值。\n\n### 九、返回结果\n\n> 针对不同操作，服务器向用户返回的结果应该符合以下规范：\n\n| 方法 | 路径 | 说明 |\n| - | - |  - |\n| GET | \u002Fcollection | 返回资源对象的列表（数组） |\n| GET | \u002Fcollection\u002Fresource | 返回单个资源对象 |\n| POST | \u002Fcollection | 返回新生成的资源对象 |\n| PUT | \u002Fcollection\u002Fresource | 返回完整的资源对象 |\n| PATCH | \u002Fcollection\u002Fresource | 返回完整的资源对象 |\n| DELETE | \u002Fcollection\u002Fresource | 返回一个空文档 |\n\n\n\n\n##  十、Hypermedia API\n\n> RESTful API最好做到Hypermedia，即返回结果中提供链接，连向其他API方法，使得用户不查文档，也知道下一步应该做什么。\n\n> 以上是Restful API设计应遵循的十大规范，除此之外，Restful API还需注意身份认证应该使用OAuth 2.0框架，服务器返回的数据格式，应该尽量使用JSON，避免使用XML。\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F55434c50d06c13c2b463a5f65df341d5.jpeg",560,"2022-07-29T06:31:23.000Z","2026-05-23T11:32:01.000Z",{"id":68,"name":69,"slug":69},{"id":295,"name":296,"avatar":289},[367],{"id":5,"name":6,"slug":6},{"id":369,"title":370,"slug":370,"content":371,"excerpt":370,"coverImage":372,"status":287,"isPinned":288,"pinnedAt":289,"viewCount":373,"publishedAt":374,"createdAt":374,"updatedAt":375,"category":376,"author":377,"tags":378},"4882bad9-06d0-4bf8-ac7f-6a14601ce875","项目规范化","\n\n## ESLint介绍\n\n- 最为流行的JavaScript lint 工具监测JS代码质量\n- ESLint很容易统一开发者的编码风格\n- ESLint可以帮助开发者提升编码能力\n\n### 初始化项目\n\n```shell\nnpm init --yes\n```\n\n### 安装ESLint依赖\n\n```shell\nnpm i eslint -D\n```\n\n### 查看版本\n\n```shell\nnpx eslint -v\n```\n\n初始化ESLint(选3、1)\n\n```\nnpx eslint --init\n```\n\n自动修复部分警告\n\n```\nnpx eslint .\\01.js --fix\n```\n\n### 事实证明，上面都是新手上路学习的，小白龙直接带你上高速\n\n## 目录结构\n\n```json\n|-- 项目名称\n    |-- .editorconfig             \u002F\u002F编辑器配置文件\n    |-- .eslintignore             \u002F\u002Feslint忽略文件\n    |-- .eslintrc.js              \u002F\u002Feslint配置文件\n    |-- .gitattributes            \u002F\u002Feslint配置文件\n    |-- .gitignore                \u002F\u002Fgit忽略文件\n    |-- .prettierignore           \u002F\u002Fprettier忽略文件\n    |-- .prettierrc.js            \u002F\u002Fprettier配置文件\n    |-- .stylelintignore          \u002F\u002Fstylelint忽略文件\n    |-- .stylelintrc.js           \u002F\u002Fstylelint配置文件\n    |-- .vscode\n    |   |-- settings.json         \u002F\u002Fvscode编辑器配置文件\n```\n\n\n\n### vscode配置\n\n|        插件         |    功能     |                             图片                             |\n| :-----------------: | :---------: | :----------------------------------------------------------: |\n|        Vetur        | 识别vue文件 | ![01](https:\u002F\u002Fcdn.xiaolong0418.com\u002Fblog\u002FSpecification\u002Fimg\u002F04.png) |\n|      Prettier       | 格式化代码  | ![01](https:\u002F\u002Fcdn.xiaolong0418.com\u002Fblog\u002FSpecification\u002Fimg\u002F02.png) |\n|       ESLint        | 规范js代码  | ![01](https:\u002F\u002Fcdn.xiaolong0418.com\u002Fblog\u002FSpecification\u002Fimg\u002F01.png) |\n| StyleLint   v0.87.6 | 规范css代码 | ![01](https:\u002F\u002Fcdn.xiaolong0418.com\u002Fblog\u002FSpecification\u002Fimg\u002F03.png) |\n\n\n\n>  在项目根目录，新建.vscode 配置settings.json\n\n```json\n{\n  \u002F\u002F根据文件后缀名定义vue文件类型\n  \\\"files.associations\\\": {\n    \\\"*.vue\\\": \\\"vue\\\"\n  },\n  \u002F\u002F配置 ESLint 检查的文件类型\n  \\\"eslint.validate\\\": [\\\"javascript\\\", \\\"javascriptreact\\\", \\\"html\\\", \\\"vue\\\"],\n  \u002F\u002F保存时\n  \\\"editor.codeActionsOnSave\\\": {\n    \u002F\u002Feslint自动修复js错误\n    \\\"source.fixAll.eslint\\\": true,\n    \u002F\u002FStyleLint自动修复css错误\n    \\\"source.fixAll.stylelint\\\": true\n  },\n  \\\"editor.formatOnSave\\\": true,\n\n  \\\"[vue]\\\": {\n    \\\"editor.defaultFormatter\\\": \\\"esbenp.prettier-vscode\\\"\n  },\n  \\\"[javascript]\\\": {\n    \\\"editor.defaultFormatter\\\": \\\"esbenp.prettier-vscode\\\"\n  },\n  \\\"[json]\\\": {\n    \\\"editor.defaultFormatter\\\": \\\"esbenp.prettier-vscode\\\"\n  },\n  \\\"[jsonc]\\\": {\n    \\\"editor.defaultFormatter\\\": \\\"esbenp.prettier-vscode\\\"\n  }\n}\n```\n\n### 在 package.json文件的 scripts加上命令, 规则检查自动修复js\n\n\n\n|          依赖          |           说明           |\n| :--------------------: | :----------------------: |\n|         eslint         |           检查           |\n| eslint-config-standard |           规范           |\n| eslint-config-prettier | 解决eslint和prettier冲突 |\n\n\n\n>  可以先用eslint初始化出.eslintrc.js，然后再安装eslint-config-standard和eslint-config-prettier(走高速的，可以忽略这段话)\n\n```shell\nnpm i -D   babel-eslint eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-vue eslint-config-prettier\n```\n\n```js\nmodule.exports = {\n  env: {\n    browser: true,\n    es2021: true,\n    node: true,\n  },\n  extends: [\\\"plugin:vue\u002Frecommended\\\", \\\"standard\\\", \\\"prettier\\\"],\n  parserOptions: {\n    ecmaVersion: 12,\n    sourceType: \\\"module\\\",\n  },\n  plugins: [\\\"vue\\\"],\n  \u002F\u002F 设置全局变量,根据自己项目需求\n  globals: {\n    _lang: true,\n    APP: true,\n    JSInterface: true,\n    finishSign: true,\n    __area: true,\n    __lang: true,\n    _host: true,\n    _app: true,\n    _area: true,\n    hosts: true,\n    _hash: true,\n    _env: true,\n    _test: true,\n    _images: true,\n    assetsRetry: true,\n    AdjustDeepLink: true,\n  },\n  rules: {\n    \u002F\u002F 禁止校验v-html xss风险\n    \\\"vue\u002Fno-v-html\\\": 0,\n  },\n};\n```\n\n### 在 package.json文件的 scripts加上命令,lint为修复js错误，style为修复css错误\n\n```json\n\\\"lint\\\": \\\"eslint --ext .js,.vue src --fix   stylelint *.scss,css,.vue\\\",\n\n\\\"style\\\": \\\"stylelint 'src\u002F**\u002F*.(vue|scss|css)' --fix\\\"\n```\n\n### webpack配置\n\n```js\n{\n test: \u002F\\.(js|vue)$\u002F,\n use: {\n  loader: \\\"babel-eslint\\\",\n },\n enforce: \\\"pre\\\", \u002F\u002F 编译前检查\n include: [resolve(\\\"src\\\")],\n},\n```\n\n\n\n# stylelint 介绍\n\n- 强大的现代 linter，可帮助您避免错误并强制执行样式中的约定。\n- 了解最新的 CSS 语法，包括自定义属性和 4 级选择器\n- 从 HTML、markdown 和 CSS-in-JS 对象和模板文本中提取嵌入的样式\n- 解析类似 CSS 的语法，如 SCSS、Sass、Less 和 SugarSS\n- 有超过170 个内置规则来捕获错误、应用限制和强制执行风格约定\n- 支持插件，因此您可以创建自己的规则或使用社区编写的插件\n- 自动修复大多数风格违规\n\n\n\n### 安装\n\n|              依赖               |   功能   |\n| :-----------------------------: | :------: |\n|            stylelint            |   检查   |\n|    stylelint-config-standard    |   规范   |\n| stylelint-config-rational-order | 书写顺序 |\n|    stylelint-config-prettier    | 解决冲突 |\n\n\n\n```shell\nnpm i -D stylelint@13.13.1 stylelint-config-standard@22.0.0 stylelint-config-rational-order@0.1.2 stylelint-config-prettier@8.0.2 stylelint-scss@3.21.0\n```\n\n\n\n### 根目录创建 stylelint.config.js 文件\n\n```js\nmodule.exports = {\n  extends: [\n    \\\"stylelint-config-standard\\\",\n    \\\"stylelint-config-rational-order\\\",\n    \\\"stylelint-config-prettier\\\",\n  ],\n  plugins: [\\\"stylelint-scss\\\"],\n  \u002F\u002F, \\\"stylelint-prettier\\\"\n  rules: {\n    \u002F\u002F在字符串周围指定单引号或双引号。\n    \u002F\u002F\\\"string-quotes\\\": \\\"single\\\",\n    \\\"property-no-unknown\\\": [\n      true,\n      {\n        ignoreProperties: [\\\"composes\\\"],\n      },\n    ],\n    \\\"selector-pseudo-class-no-unknown\\\": [\n      true,\n      {\n        ignorePseudoClasses: [\\\"global\\\"],\n      },\n    ],\n    \\\"at-rule-no-unknown\\\": null,\n    \\\"scss\u002Fat-rule-no-unknown\\\": null,\n  },\n};\n```\n\n\n\n### 忽略stylelint对css的检验\n\n> 忽略整个文件，在首行加入 `\u002F* stylelint-disable *\u002F`\n\n```css\n\u002F* stylelint-disable *\u002F\nhtml {}\n```\n\n> 忽略多行\n\n```css\n\u002F* stylelint-disable *\u002F\nhtml {}\n.div {\n    color: red;\n}\n\u002F* stylelint-enable *\u002F\n```\n\n> 忽略一行， 在样式前加入 \u002F* stylelint-disable-next-line *\u002F 以忽略该行\n\n```css\n#id {\n  \u002F* stylelint-disable-next-line *\u002F\n  color: pink !important;\n}\n```\n\n> 在 .stylelintrc.json 內设定需要忽略的文件\n\n```sh\n{\n  ignoreFiles: [\\\"dist\u002F**\u002F*\\\", \\\"src\u002Fassets\u002Fscss\u002Fabc.scss\\\"]\n}\n```\n\n\n\n## husky + lint-staged 构建代码工作流\n\n- husky是一个 Git Hook 工具,它可以在代码提交前允许我们做一些事情，从而防止一些不好的代码被提交上去。\n\n- lint-staged是针对工作区修改的文件,这对我们只希望处理将要提交的文件将会非常有用。\n\n### 安装 husky lint-staged 依赖\n\n> 注意 windows 用户需要使用 npm 包管理器安装不然 git hooks会失效\n\n```shell\nyarn add -D husky lint-staged\n```\n\n\n\n### 配置 husky & lint-staged\n\n- 我们需要在代码提交前对代码做一下格式化并且如果代码不符合规范就不让提交,简单的做法就是在`husky`的`pre-commit`钩子去运行 `lint-staged`,`lintstaged `主要就干了三件事：\n\n- 第一件就是调用`eslint --ext .js,.vue src --fix` 修复不合符eslint规范的代码。\n\n- 第二件`stylelint 'src\u002F**\u002F*.(vue|scss|css)' --fix`修复不合符css规范的代码。\n\n- 最后如果都通过了就允许代码`commit`。\n\n```json\n  \\\"husky\\\": {\n    \\\"hooks\\\": {\n      \\\"pre-commit\\\": \\\"lint-staged\\\"\n    }\n  },\n  \\\"lint-staged\\\": {\n    \\\"*{.ts,.js}\\\":[\n      \\\"eslint --ext .js,.vue src --fix\\\",\n      \\\"stylelint 'src\u002F**\u002F*.(vue|scss|css)' --fix\\\",\n      \\\"git add\\\"\n    ]\n  }\n```\n\n\n### 2022\u002F8\u002F27加强版本\n\n### 安装husky\n```shell\npnpm add husky -D\n```\n\n### 快速创建husky目录\n```shell\nnpx --no-install husky install\n```\n> --no-install 参数表示强制 npx 使用项目中 node_modules 目录下的husky依赖包\n\n\n### 在.hucky文件夹中创建pre-commit文件\n```js\n#!\u002Fbin\u002Fsh\n. \\\"$(dirname \\\"$0\\\")\u002F_\u002Fhusky.sh\\\"\n\nnpm run lint\n```\n> pre-commit 在 commit 之前会执行 npm run lint 校验代码，可以定义你的执行脚本，校验不通过不允许 commit 提交\n\n### commitizen\n> commitizen 是一个撰写符合 Commit Message 标准的一款工具。通过它可以实现交互式撰写规范的 Commit Message。\n```shell\npnpm  add commitizen -D\n```\n> 安装完成后，一般我们都采用符合 Angular 的 Commit message 格式的提交规范，运行以下命令生成符合 Angular 提交规范格式的 Commit message\n\n```shell\nnpx --no-install commitizen init cz-conventional-changelog --save-dev --save-exact\n```\n\n### 在 package.json scrips 添加 \\\"commit\\\": \\\"git-cz\\\" 命令\n\n```language\nscripts: {\n  \\\"commit\\\": \\\"git add .\u002F && git-cz\\\"\n}\n```\n\n### 限制 commitlint\n\n> 由于 commitizen 并不是强制使用的，仍然可以通过 git commit 来提交，所以不管是 git-cz 还是 git commit 提交前，都要对 commit messag 进行一次校验，不符合规范的情况下是不允许进行 commit\n```shell\npnpm add @commitlint\u002Fcli @commitlint\u002Fconfig-conventional -D\n```\n\n### 在.hucky文件夹中创建commit-msg文件\n```js\n#!\u002Fbin\u002Fsh\n. \\\"$(dirname \\\"$0\\\")\u002F_\u002Fhusky.sh\\\"\n\nnpx --no-install commitlint --edit $1\n```\n\n### 根目录创建配置文件 commitlint.config.js\n```js\nmodule.exports = {\n  ignores: [(commit) => commit.includes('init')],\n  extends: ['@commitlint\u002Fconfig-conventional', 'cz'],\n  rules: {\n    'body-leading-blank': [2, 'always'],\n    'footer-leading-blank': [1, 'always'],\n    'header-max-length': [2, 'always', 108],\n    'subject-empty': [2, 'never'],\n    'type-empty': [2, 'never'],\n    'subject-case': [0],\n    'type-enum': [\n      2,\n      'always',\n      [\n        'feat',\n        'fix',\n        'perf',\n        'style',\n        'docs',\n        'test',\n        'refactor',\n        'build',\n        'ci',\n        'chore',\n        'revert',\n        'wip',\n        'workflow',\n        'types',\n        'release'\n      ]\n    ]\n  }\n}\n```\n\n### 上面的提示都是英文的，如果想自定义翻译成中文，需要安装 cz-customizable 来实现自定义 commit message 规则，以及安装对应的 commitlint-config-cz 来配套校验\n```shell\npnpm add cz-customizable  commitlint-config-cz -D\n```\n\n### 项目根目录，创建一个 .cz-config.js 文件\n```js\n\u002F\u002F .cz-config.js\nmodule.exports = {\n  types: [\n    { value: ':sparkles: feat', name: '✨ feat: 一项新功能' },\n    { value: ':bug: fix', name: '🐛 fix: 修复一个Bug' },\n    { value: ':memo: docs', name: '📝 docs: 文档变更' },\n    { value: ':lipstick: style', name: '💄 style: 代码风格，格式修复' },\n    { value: ':recycle: refactor', name: '♻️ refactor: 代码重构，注意和feat、fix区分开' },\n    { value: ':zap: perf', name: '⚡️ perf: 代码优化,改善性能' },\n    { value: ':white_check_mark: test', name: '✅ test: 测试' },\n    { value: ':rocket: chore', name: '🚀 chore: 变更构建流程或辅助工具' },\n    { value: ':rewind: revert', name: ':rewind: revert: 代码回退' },\n    { value: ':tada: init', name: '🎉 init: 项目初始化' },\n    { value: ':construction_worker: ci', name: '👷 对CI配置文件和脚本的更改' },\n    { value: ':package: build', name: '📦️ build: 变更项目构建或外部依赖' },\n    { value: ':construction: WIP', name: '🚧 WIP: 进行中的工作' }\n  ],\n  scopes: [\n    { name: 'component' },\n    { name: 'config' },\n    { name: 'docs' },\n    { name: 'src' },\n    { name: 'examples' },\n    { name: 'play' }\n  ],\n  \u002F\u002F allowTicketNumber: false,\n  \u002F\u002F isTicketNumberRequired: false,\n  \u002F\u002F ticketNumberPrefix: 'TICKET-',\n  \u002F\u002F ticketNumberRegExp: '\\\\d{1,5}',\n  \u002F\u002F it needs to match the value for field type. Eg.: 'fix'\n  \u002F\u002F scopeOverrides: {\n  \u002F\u002F   feat: [\n  \u002F\u002F     { name: 'element' }\n  \u002F\u002F   ],\n  \u002F\u002F   fix: [\n  \u002F\u002F     { name: 'element' },\n  \u002F\u002F     { name: 'style' },\n  \u002F\u002F   ]\n  \u002F\u002F },\n  \u002F\u002F override the messages, defaults are as follows\n  messages: {\n    type: '请选择提交类型(必填):',\n    scope: '请选择一个scope (可选):',\n    customScope: '请输入文件修改范围(可选):',\n    \u002F\u002F used if allowCustomScopes is true\n    subject: '请简要描述提交(必填):',\n    body: '请输入详细描述，使用\\\"|\\\"换行(可选):\\\n',\n    breaking: '列出任务非兼容性说明 (可选):\\\n',\n    footer: '请输入要关闭的issue，例如：#12, #34(可选):\\\n',\n    confirmCommit: '确定提交此说明吗？'\n  },\n  allowCustomScopes: true,\n  allowBreakingChanges: ['feat', 'fix'],\n  \u002F\u002F 限制 subject 长度\n  subjectLimit: 72\n  \u002F\u002F 跳过问题 skip any questions you want\n  \u002F\u002F skipQuestions: ['body', 'footer'],\n  \u002F\u002F breaklineChar: '|', \u002F\u002F It is supported for fields body and footer.\n  \u002F\u002F footerPrefix : 'ISSUES CLOSED:'\n  \u002F\u002F askForBreakingChangeFirst : true, \u002F\u002F default is false\n}\n```\n> 创建完 .cz-config.js 文件后，我们需要回到 package.json 文件中，将 config.commitizen.path 更改为 node_modules\u002Fcz-customizable\n```js\n{\n  \\\"config\\\": {\n    \\\"commitizen\\\": {\n      \\\"path\\\": \\\"node_modules\u002Fcz-customizable\\\"\n    }\n  }\n}\n```\n\n### 为了提交更好看，在 commit 头部添加了表情 gitmoji，需要安装这个插件\n\n```shell\npnpm add commitlint-config-gitmoji -D\n```\n\n### 修改 .commitlintrc.js 内容\n```js\nmodule.exports = {\n  \u002F\u002F extends: ['@commitlint\u002Fconfig-conventional', 'cz'],\n  extends: ['gitmoji']\n}\n```\n\n### 执行 pnpm commit 可以看到带表情的中文 commit message\n\n\n\n\n","https:\u002F\u002Fcdn.xiaolong0418.com\u002Fmyblog\u002Fimages\u002F1657981737234.png",961,"2022-07-16T14:29:11.000Z","2026-05-25T02:21:21.000Z",{"id":64,"name":65,"slug":65},{"id":295,"name":296,"avatar":289},[379],{"id":5,"name":6,"slug":6}]