\n\n### Expected behavior\n\nI hope to use SVG and other methods instead of using masks to display icons, which can avoid frequent redrawing\n\n### System Info\n\n```Text\n\"vitepress\": \"^1.6.4\",\n```\n\n### Additional context\n\n\u003Cimg width=\"2559\" height=\"1042\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/39db5990-f3ee-47bb-8bcf-49272a1918f4\" />\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3174],{"name":3163,"color":3164},4917,"Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.67221606,{"description":3181,"labels":3182,"number":3184,"owner":3152,"repository":3153,"state":3185,"title":3186,"updated_at":3187,"url":3188,"score":3189},"### Describe the bug\n\nThe browser console prints Hydration completed but contains mismatches when deploying the site using Github pages. And the page switch does not work as expected.\r\n\r\n\u003Cimg width=\"404\" alt=\"image\" src=\"https://user-images.githubusercontent.com/25716486/183507530-a390b50c-49e1-4349-a5ba-e1add6883280.png\">\r\n\u003Cimg width=\"1015\" alt=\"image\" src=\"https://user-images.githubusercontent.com/25716486/183507583-86f736b4-7954-40e1-a5aa-a89298d68c72.png\">\r\n\n\n### Reproduction\n\nHere is a reproduced repo: https://github.com/Corona-Studio/CSKB_Hosting\n\n### Expected behavior\n\nThe page switch buttons should work after a click.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22000\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11800H @ 2.30GHz\r\n Memory: 13.26 GB / 31.82 GB\r\n Binaries:\r\n Node: 18.4.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\node_modules\\.bin\\yarn.CMD\r\n npm: 8.13.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22000.120.0), Chromium (104.0.1293.47)\r\n Internet Explorer: 11.0.22000.120\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.4 => 1.0.0-alpha.4\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3183],{"name":3163,"color":3164},1143,"closed","Hydration completed but contains mismatches when using Github pages","2023-01-21T14:28:46Z","https://github.com/vuejs/vitepress/issues/1143",0.59258443,{"description":3191,"labels":3192,"number":3194,"owner":3152,"repository":3153,"state":3185,"title":3195,"updated_at":3196,"url":3197,"score":3198},"### Describe the bug\n\nIf I go to my project home and click on the link to a post, I am able to access the post. If I go to a direct link to a post, or I refresh my page while on a post I will get the \"Hydration completed but contains mismatches\" in the console and the page goes blank.\n\n### Reproduction\n\nI have included the source code at https://github.com/ak-tr/blog.akif.kr/tree/main\r\nThe website is also deployed to Firebase Hosting at https://blog.akif.kr\r\n\r\nTo reproduce, go to https://blog.akif.kr, and click on the first (and only) post. There are no issues. Now refresh, and you will get the said error.\n\n### Expected behavior\n\nPost loads on refresh or on when accessed directly.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.0\r\n CPU: (8) arm64 Apple M1 Pro\r\n Memory: 126.19 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.5.0 - ~/.nvm/versions/node/v20.5.0/bin/node\r\n npm: 9.8.0 - ~/.nvm/versions/node/v20.5.0/bin/npm\r\n Browsers:\r\n Chrome: 121.0.6167.160\r\n Safari: 17.0\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.40 => 1.0.0-rc.42\n```\n\n\n### Additional context\n\nI do use Cloudflare and have disabled minification for all files on that domain. I have purged all the cache and it has been over 18 hours since I made the change so even if the purge didn't work for whatever reason, I assume the cache would've died by now.\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3193],{"name":3163,"color":3164},3562,"Hydration completed but contains mismatches","2024-02-16T00:04:28Z","https://github.com/vuejs/vitepress/issues/3562",0.6079485,{"description":3200,"labels":3201,"number":3203,"owner":3152,"repository":3153,"state":3185,"title":3204,"updated_at":3205,"url":3206,"score":3207},"### Describe the bug\r\n\r\nWhen I add some url params `?a=1&b=2` after the page's URL, the console log an error `Hydration completed but contains mismatches.` and the page rendering is incorrect\r\n\r\n### Reproduction\r\n\r\n1. Clone from `https://github.com/GlobeMC/crashmc.com`\r\n2. `pnpm run docs:build && pnpm run docs:preview`\r\n3. Access \u003Chttp://localhost:4173/client/system.html> and \u003Chttp://localhost:4173/client/system.html?someparam=somevalue>\r\n4. The page without param will works well, but the page with the URL param will somehow mixed with the home page's content\r\n\r\n### Expected behavior\r\n\r\nThe two pages should looks exactly same.\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 14.1.1\r\n CPU: (8) arm64 Apple M1 Pro\r\n Memory: 149.67 MB / 16.00 GB\r\n Shell: 3.2.57 - /bin/bash\r\n Binaries:\r\n Node: 21.4.0 - /opt/homebrew/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 10.3.0 - /opt/homebrew/bin/npm\r\n pnpm: 8.6.12 - /opt/homebrew/bin/pnpm\r\n Browsers:\r\n Chrome: 120.0.6099.216\r\n npmPackages:\r\n vitepress: 1.0.0-rc.39 => 1.0.0-rc.39\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nI am not sure if it is a vitepress route issue or if it's a pwa route issue, I tried made an example without pwa but it don't have problem\r\n\r\nA live example can be \u003Chttps://beta.crashmc.com/analyzer.html> and \u003Chttps://beta.crashmc.com/analyzer.html?>\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3202],{"name":3163,"color":3164},3469,"\"Hydration completed but contains mismatches\" when path contains URL params","2024-01-26T00:04:26Z","https://github.com/vuejs/vitepress/issues/3469",0.61897826,{"description":3209,"labels":3210,"number":3212,"owner":3152,"repository":3153,"state":3185,"title":3213,"updated_at":3214,"url":3215,"score":3216},"### Describe the bug\r\n\r\nThis ones tricky. I think it may be related to #1918 \r\n\r\nOn prod, getting `hydration mismatch error` on my theme\r\nhttps://github.com/jcamp-code/vitepress-blog-theme\r\n\r\nOn initial load, the HTML is correct (you see the post excerpt) but it flashes away in milliseconds.\r\n\r\nWondering if it has to do with the v-html:\r\n\r\n```\r\n\u003Cp class=\"mb-5 font-light\" v-html=\"post.excerpt\" />\r\n```\r\n\r\nThis looks related:\r\nhttps://github.com/vuejs/core/issues/6435\r\n\r\nBut I did the [workaround](https://play.vuejs.org/#__SSR__eNpNjz8LgzAQxb/KkSUKoru1hdKlQ7t1qx1Ke6JgTEhOESTfvfmjxRvC5d27H+8WdlYqn0ZkJasIherfhKd6AKi+3RQa115GQ1I8cCYoyb3HmnFCQ7xmUER3Ee1VsYNU5qM7RWCQRuX+nVBSE+xojZYCeF5cpAgpuCfErRPL2Cb7cKv6pyzQgl0BcRPnMPhi8x57Z/C5lJbKlE+Xdib+yrwU0iRhkEYTgHaaHiBJ4bjeDNAm3N3Es83jqxsG1NfH/VZGcu65gerLpgffWifY/SH2B6Tydgw=) suggested but it made no difference. It's like `excerpt` is not getting loaded\r\n\r\n### Reproduction\r\n\r\nEasily seen here:\r\nhttps://deploy-preview-2--vitepress-blog.netlify.app/blog/\r\n\r\nGo to it and then reload the page and you'll see the hydration mismatch\r\n\r\nhttps://github.com/jcamp-code/vitepress-blog-theme\r\n\r\nClone it\r\n\r\n```pnpm serve```\r\n\r\nGo to: \r\nhttp://localhost:4173/blog/\r\n\r\nLoaded directly, you'll see the excerpts are missing. If you go to another page and come back it displays correctly.\r\n\r\n### Expected behavior\r\n\r\nCorrect display of page upon hydration\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.3.1\r\n CPU: (12) arm64 Apple M2 Pro\r\n Memory: 94.23 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.14.1 - /usr/local/bin/node\r\n npm: 9.5.0 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 112.0.5615.137\r\n Firefox: 111.0.1\r\n Safari: 16.4\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.74 => 1.0.0-alpha.74\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n_No response_\r\n\r\n### Validations\r\n\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3211],{"name":3163,"color":3164},2293,"bug: hydration mismatch","2023-05-04T00:04:02Z","https://github.com/vuejs/vitepress/issues/2293",0.6225103,{"description":3218,"labels":3219,"number":3221,"owner":3152,"repository":3153,"state":3185,"title":3222,"updated_at":3223,"url":3224,"score":3225},"### Describe the bug\n\n知乎热搜榜不更新\n这是itab 知乎\n\n\u003Cimg width=\"1579\" height=\"903\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7604efd0-49a5-495c-9fd6-8d24549f2e27\" />\n这是知乎网站的热搜榜\n\n\u003Cimg width=\"807\" height=\"942\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/092b0749-e7d2-4b00-bd5b-172b6725c892\" />\n\n### Reproduction\n\n希望能更新接口,获取最新热搜数据\n\n### Expected behavior\n\n希望能更新接口,获取最新热搜数据\n\n### System Info\n\n```Text\n1.6.20\n```\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3220],{"name":3163,"color":3164},4866,"知乎热搜榜不更新","2025-07-30T04:05:01Z","https://github.com/vuejs/vitepress/issues/4866",0.64442974,{"description":3227,"labels":3228,"number":3229,"owner":3152,"repository":3153,"state":3185,"title":3195,"updated_at":3230,"url":3231,"score":3232},"### Describe the bug\n\nIt will report errors in production\r\n\r\n\r\napp.b77605b4.js:1 Hydration completed but contains mismatches\n\n### Reproduction\n\n*\n\n### Expected behavior\n\nIt will report errors in production\r\n\r\n\r\napp.b77605b4.js:1 Hydration completed but contains mismatches\n\n### System Info\n\n```shell\nwindows\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[],1627,"2023-01-21T16:04:00Z","https://github.com/vuejs/vitepress/issues/1627",0.6471448,{"description":3234,"labels":3235,"number":3239,"owner":3152,"repository":3153,"state":3185,"title":3240,"updated_at":3241,"url":3242,"score":3243},"### Describe the bug\n\n使用官方文档的部署脚本成功部署到Github Pages之后,此时如果配置使用自定义域名的话,访问时样式会丢失\n\n### Reproduction\n\n1. 博客目录结构如下所示:\u003Cbr />\r\n2. 配置文件如下所示:\u003Cbr /> \n\n### Expected behavior\n\n使用 Github 自带的 https://xihuanxiaorang.github.io/docs/ 访问就没有任何问题,如果是使用自定义域名 https://docs.xiaorang.fun/ 的话,样式就会丢失\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (4) x64 Intel(R) Core(TM) i5-5200U CPU @ 2.20GHz\r\n Memory: 659.73 MB / 3.92 GB\r\n Binaries:\r\n Node: 20.11.0 - E:\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - E:\\nodejs\\node_global\\yarn.CMD\r\n npm: 10.2.4 - E:\\nodejs\\npm.CMD\r\n pnpm: 8.14.3 - E:\\nodejs\\node_global\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.144)\r\n Internet Explorer: 11.0.19041.3636\r\n npmPackages:\r\n vitepress: 1.0.0-rc.40 => 1.0.0-rc.40\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3236],{"name":3237,"color":3238},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.6502287,["Reactive",3245],{},["Set"],["ShallowReactive",3248],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fjh_E98S_KyBR1P3Qvhdu93P3tZ-BVzloDYQR3c5anLI":-1},"/vuejs/vitepress/3322"]