\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.",[3162],{"name":3146,"color":3147},4917,"Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.62389165,{"description":3169,"labels":3170,"number":3172,"owner":3152,"repository":3153,"state":3173,"title":3174,"updated_at":3175,"url":3176,"score":3177},"### Describe the bug\r\n\r\n在 vitepress 文档环境中 引用x6 组件,会提示navigate不存在。\r\n\r\n\r\n\r\n### Reproduction\r\n\r\n``` bash\r\nyarn build:docs\r\n```\r\n\r\n### Expected behavior\r\n\r\n希望能够正常引入 x6, 或者提供一个 使用x6的最佳实践\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 11.4\r\n CPU: (12) x64 Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz\r\n Memory: 891.16 MB / 16.00 GB\r\n Shell: 5.8 - /bin/zsh\r\n Binaries:\r\n Node: 14.15.0 - ~/.nvm/versions/node/v14.15.0/bin/node\r\n Yarn: 1.22.10 - /usr/local/bin/yarn\r\n npm: 6.14.8 - ~/.nvm/versions/node/v14.15.0/bin/npm\r\n Browsers:\r\n Chrome: 92.0.4515.131\r\n Safari: 14.1.1\r\nmodule\r\n \"vite\": \"^2.4.4\",\r\n \"vitepress\": \"^0.15.6\",\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n\r\n\r\n### Validations\r\n\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\r\n- [X] Read the [docs](https://vitepress.vuejs.org/).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3171],{"name":3146,"color":3147},349,"closed","vitepress build x6 error","2023-01-21T16:22:15Z","https://github.com/vuejs/vitepress/issues/349",0.5643757,{"description":3179,"labels":3180,"number":3182,"owner":3152,"repository":3153,"state":3173,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### Describe the bug\n\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-pzpqo8?file=docs%2F.vitepress%2Ftheme%2Fx.ts\r\n\r\n在 `theme/x.ts` 中引入了 `echarts` ,开发时是可以的,页面正常显示。构建时报错。\r\n\r\n\r\n\r\n**如果是一个纯 vite 项目,构建不错误**\n\n### Expected behavior\n\n正常编译不出错\n\n### System Info\n\n```sh\nSystem:\r\n OS: macOS 13.4\r\n CPU: (12) x64 Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz\r\n Memory: 48.46 MB / 32.00 GB\r\n Shell: 3.2.57 - /bin/bash\r\n Binaries:\r\n Node: 16.18.1 - ~/Library/Caches/fnm_multishells/19014_1691646234602/bin/node\r\n Yarn: 1.22.19 - ~/Library/pnpm/yarn\r\n npm: 8.19.2 - ~/Library/Caches/fnm_multishells/19014_1691646234602/bin/npm\r\n pnpm: 8.6.8 - ~/Library/pnpm/pnpm\r\n npmPackages:\r\n vitepress: 1.0.0-rc.4 => 1.0.0-rc.4\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.",[3181],{"name":3146,"color":3147},2769,"引入 echarts 编译时报错","2023-08-18T00:04:16Z","https://github.com/vuejs/vitepress/issues/2769",0.5682957,{"description":3188,"labels":3189,"number":3191,"owner":3152,"repository":3153,"state":3173,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### Describe the bug\n\n版本:\"vitepress\": \"^1.0.0-alpha.35\", \r\n里面没有多余的东西。就是按照官网https://vitepress.vuejs.org/guide/getting-started 走到了第三步。然后将 index.md 的内容添加了 {1}\r\n\r\n\r\n\r\n\n\n### Reproduction\n\n按照官网https://vitepress.vuejs.org/guide/getting-started 走到了第三步。然后将 index.md 的内容添加了 {1}\n\n### Expected behavior\n\n正常渲染 {1} 标签的内容\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22621\r\n CPU: (20) x64 12th Gen Intel(R) Core(TM) i7-12700H\r\n Memory: 1.50 GB / 15.73 GB\r\n Binaries:\r\n Node: 16.15.1 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.11.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22621.963.0), Chromium (108.0.1462.76)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.35 => 1.0.0-alpha.35\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.",[3190],{"name":3146,"color":3147},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.5705813,{"description":3197,"labels":3198,"number":3200,"owner":3152,"repository":3153,"state":3173,"title":3201,"updated_at":3202,"url":3203,"score":3204},"### Describe the bug\r\n\r\n指定端口号后热更新失效,恢复默认之后热更新依旧不生效\r\n\r\n### Reproduction\r\n\r\nvitepress dev docs --host --port 9999\r\n\r\n### Expected behavior\r\n\r\n热更新生效\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem: \r\n OS: Windows 10 10.0.19044 \r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11800H @ 2.30GHz\r\n Memory: 44.27 GB / 63.71 GB \r\n Binaries: \r\n Node: 14.18.2 - C:\\Program Files\\nodejs\\node.EXE \r\n Yarn: 1.22.19 - C:\\Program Files (x86)\\Yarn\\bin\\yarn.CMD \r\n npm: 6.14.15 - C:\\Program Files\\nodejs\\npm.CMD \r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (112.0.1722.68)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.75 => 1.0.0-alpha.75\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] 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.",[3199],{"name":3146,"color":3147},2349,"热更新","2023-05-24T00:03:54Z","https://github.com/vuejs/vitepress/issues/2349",0.5790722,{"description":3206,"labels":3207,"number":3209,"owner":3152,"repository":3153,"state":3173,"title":3210,"updated_at":3211,"url":3212,"score":3213},"### 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.",[3208],{"name":3146,"color":3147},4866,"知乎热搜榜不更新","2025-07-30T04:05:01Z","https://github.com/vuejs/vitepress/issues/4866",0.5916667,{"description":3215,"labels":3216,"number":3220,"owner":3152,"repository":3153,"state":3173,"title":3221,"updated_at":3222,"url":3223,"score":3224},"### 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.",[3217],{"name":3218,"color":3219},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.5989911,{"description":3226,"labels":3227,"number":3229,"owner":3152,"repository":3153,"state":3173,"title":3230,"updated_at":3231,"url":3232,"score":3233},"### Describe the bug\n\n路由中中文锚点刷新时由于编码导致报错\r\n\r\n\u003Cimg width=\"1263\" alt=\"Snipaste_2023-03-15_13-14-37\" src=\"https://user-images.githubusercontent.com/37688666/225213537-b55d97a4-69ca-4c7a-9077-ec4b82b412c5.png\">\r\n\n\n### Reproduction\n\n无\n\n### Expected behavior\n\n支持中文锚点\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11800H @ 2.30GHz\r\n Memory: 40.44 GB / 63.71 GB\r\n Binaries:\r\n Node: 14.18.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files (x86)\\Yarn\\bin\\yarn.CMD\r\n npm: 6.14.15 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.69)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: * => 1.0.0-alpha.56\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.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3228],{"name":3146,"color":3147},2089,"锚点链接中文错误","2023-03-23T00:04:21Z","https://github.com/vuejs/vitepress/issues/2089",0.5999164,{"description":3235,"labels":3236,"number":3238,"owner":3152,"repository":3153,"state":3173,"title":3239,"updated_at":3240,"url":3241,"score":3242},"### Describe the bug\n\nAfter updating to vitepress@1.0.0-rc.40 (and still confirmed in vitepress@1.0.0-rc.42), we can no longer use vitepress's development mode via `vitepress dev`.\r\nWhile the CLI app runs without visible errors, the browser only shows an empty screen. In the browser console, the following warnings and error are shown:\r\n\u003Cimg width=\"662\" alt=\"vitepress-error\" src=\"https://github.com/vuejs/vitepress/assets/12949268/f6b73163-1a5f-4890-8c28-0c5744000ef3\">\r\nAs this does not seem to originate from our own code, we are not sure we can do anything about it. At the moment, we avoid the issue by pinning vitepress to vitepress@1.0.0-rc.39.\r\n\r\n\n\n### Reproduction\n\n```shell\r\ngit clone git@github.com:rollup/rollup.git\r\ncd rollup\r\nnpm install --ignore-scripts\r\nnpm install vitepress@latest\r\nnpm run dev\r\n```\n\n### Expected behavior\n\nOpening http://localhost:5173/ in the browser shows the Rollup website.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.3.1\r\n CPU: (12) arm64 Apple M2 Max\r\n Memory: 14.80 GB / 64.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.5.1 - ~/.asdf/installs/nodejs/20.5.1/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 9.8.0 - ~/.asdf/plugins/nodejs/shims/npm\r\n pnpm: 8.14.1 - ~/.asdf/installs/nodejs/20.5.1/bin/pnpm\r\n Browsers:\r\n Chrome: 121.0.6167.184\r\n Safari: 17.3.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.42 => 1.0.0-rc.42\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.",[3237],{"name":3146,"color":3147},3579,"vitepress@1.0.0-rc.40+ breaks vitepress dev","2024-02-27T00:05:56Z","https://github.com/vuejs/vitepress/issues/3579",0.6078227,["Reactive",3244],{},["Set"],["ShallowReactive",3247],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fS8HWZZBjwizxvBOlttHf0pFVzfD5ohtXZBHBZgdp0Yo":-1},"/vuejs/vitepress/2772"]