\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.",[3173],{"name":3174,"color":3175},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.65235233,{"description":3182,"labels":3183,"number":3187,"owner":3152,"repository":3153,"state":3165,"title":3188,"updated_at":3189,"url":3190,"score":3191},"### Describe the bug\r\n\r\nUsing the newly released `v1.0.0-alpha.41` results in my browser URL being re-written to the root when previewing the Vitepress site with a configured `base`:\r\n\r\n```js\r\nexport default {\r\n title: 'API Docs',\r\n description: 'My API Docs',\r\n base: '/docs/',\r\n}\r\n```\r\n\r\n### Resolution\r\n\r\nDowngrading to `v1.0.0-alpha.40` resolves this issue. No redirect/URL rewrite occurs.\r\n\r\nI suspect it's due to this new feature: https://github.com/vuejs/vitepress/pull/1798\r\n\r\n### Reproduction\r\n\r\n1. Create a new Vitepress site\r\n2. Set the `base` configuration option to `/docs/`\r\n3. Run `yarn docs:build`\r\n4. Run `yarn docs:preview`\r\n5. Navigate to the served site\r\n6. Notice how the URL is rewritten to the root host, and `/docs/` is removed from the URL\r\n\r\n### Expected behavior\r\n\r\nThe URL should not be rewritten to the root host. `/docs/` should be preserved.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.2\r\n CPU: (12) x64 Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz\r\n Memory: 98.54 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.17.1 - ~/.nvm/versions/node/v16.17.1/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 8.15.0 - ~/.nvm/versions/node/v16.17.1/bin/npm\r\n Browsers:\r\n Chrome: 109.0.5414.119\r\n Firefox: 100.0.2\r\n Safari: 16.3\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.40 => 1.0.0-alpha.40 \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.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3184],{"name":3185,"color":3186},"build","377ba8",1857,"v1.0.0-alpha.41 breaks `base` config option -- URL always rewrites to root","2023-02-06T00:04:30Z","https://github.com/vuejs/vitepress/issues/1857",0.6569414,{"description":3193,"labels":3194,"number":3196,"owner":3152,"repository":3153,"state":3165,"title":3197,"updated_at":3198,"url":3199,"score":3200},"### Describe the bug\n\nIf the path or filename includes '+', it will have a type error\r\n\r\n\r\n\r\n\n\n### Reproduction\n\njust rename the path or filename to include '+'\n\n### Expected behavior\n\nNo error\n\n### System Info\n\n```sh\nSystem:\r\n OS: Windows 10 10.0.22621\r\n CPU: (8) x64 Intel(R) Core(TM) i7-6700 CPU @ 3.40GHz\r\n Memory: 6.72 GB / 15.89 GB\r\n Binaries:\r\n Node: 18.16.1 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.6.7 - C:\\Program Files\\nodejs\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22621.2134.0), Chromium (116.0.1938.62)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.10 => 1.0.0-rc.10\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.",[3195],{"name":3146,"color":3147},2872,"Rewrites error when the path or filename includes '+'","2023-09-06T00:04:11Z","https://github.com/vuejs/vitepress/issues/2872",0.65999883,{"description":3202,"labels":3203,"number":3205,"owner":3152,"repository":3153,"state":3165,"title":3206,"updated_at":3207,"url":3208,"score":3209},"### Describe the bug\n\nFailed to import the file from the relative path after rewriting。\r\n\r\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-9syvzp?file=docs%2F.vitepress%2Fconfig.ts\n\n### Expected behavior\n\nI want to import the file successfully using a relative path\n\n### System Info\n\n```sh\n\"vitepress\": \"1.0.0-beta.5\"\r\n\"node\": \"18.16.0\"\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.",[3204],{"name":3146,"color":3147},2662,"after rewrite, import error","2023-07-29T00:04:14Z","https://github.com/vuejs/vitepress/issues/2662",0.66426575,{"description":3211,"labels":3212,"number":3214,"owner":3152,"repository":3153,"state":3165,"title":3215,"updated_at":3216,"url":3217,"score":3218},"### Describe the bug\r\n\r\nI'm migrate vue-i18n docs site with vitepress v1 alpha.4\r\nThe config.ts for that docs consists of Mulutiple Sidbars.\r\nConfig.ts is here:\r\nhttps://github.com/intlify/vue-i18n-next/blob/docs/vitepress1/docs/.vitepress/config.ts\r\n\r\n`/guide/` sidebar has items, but it’s wried, we will access the `Message Format Syntax` and `Fallbacking` items resulting in a 404.\r\n\r\nThese settings are here.\r\n- `Message Format Syntax`: https://github.com/intlify/vue-i18n-next/blob/e59dcca32e1aa6af966651f02bb624081299c2bf/docs/.vitepress/config.ts#L114-L117\r\n- `Fallbacking`: https://github.com/intlify/vue-i18n-next/blob/e59dcca32e1aa6af966651f02bb624081299c2bf/docs/.vitepress/config.ts#L134-L137\r\n\r\nThe previous version of vitepress worked, so here is the site URL and config for your reference.\r\n\r\n- URL: https://vue-i18n.intlify.dev/\r\n- config: https://github.com/intlify/vue-i18n-next/blob/master/docs/.vitepress/config.js\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nRepository: https://github.com/intlify/vue-i18n-next\r\n\r\nReproduction step:\r\n1. `git clone git@github.com:intlify/vue-i18n-next.git`\r\n2. `git checkout docs/vitepress1`\r\n3. `pnpm install`\r\n4. `pnpm docs:setup`\r\n5. `pnpm docs:dev`\r\n6. go to http://localhost:3000/\r\n7. go to Guid via navigation `Guide` menu\r\n8. go to [Message Format Syntax](http://localhost:3000/guide/essentials/syntax.html) via sidebar\r\n9. go to [Fallbacking](http://localhost:3000/guide/essentials/fallback.html) via sidebar \r\n\r\n### Expected behavior\r\n\r\nI hope that 404 won't occur on these pages\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 10.15.7\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz\r\n Memory: 9.93 GB / 64.00 GB\r\n Shell: 5.7.1 - /bin/zsh\r\n Binaries:\r\n Node: 18.4.0 - ~/bin/.nvm/versions/node/v18.4.0/bin/node\r\n npm: 8.12.1 - ~/bin/.nvm/versions/node/v18.4.0/bin/npm\r\n Browsers:\r\n Chrome: 103.0.5060.53\r\n Firefox: 97.0.1\r\n Safari: 15.5\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.4 => 1.0.0-alpha.4\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.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3213],{"name":3146,"color":3147},885,"Occured 404 in some pages","2023-01-21T14:32:52Z","https://github.com/vuejs/vitepress/issues/885",0.6661978,{"description":3220,"labels":3221,"number":3223,"owner":3152,"repository":3153,"state":3165,"title":3224,"updated_at":3225,"url":3226,"score":3227},"### Describe the bug\n\nhttps://flowbite-vue.com/pages/getting-started\n\n\u003Cimg width=\"97\" height=\"103\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/eb9f85c1-6df8-47e9-950a-8b1aeb92b7ba\" />\n\n\n```vue\n\u003Cscript setup>\nimport { FwbButton } from 'flowbite-vue'\n\u003C/script>\n\u003Ctemplate>\n \u003Cdiv>\n \u003Cfwb-button color=\"default\">Default\u003C/fwb-button>\n \u003C/div>\n\u003C/template>\n```\n\n### Reproduction\n\nhttps://github.com/jk2K/testvitepress\n\ntech stack\n1. https://flowbite-vue.com/pages/getting-started\n2. tailwindcss v4\n\n### Expected behavior\n\n\u003Cimg width=\"103\" height=\"50\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7bffdf53-2faf-4257-87c2-4f60511b7060\" />\n\n### System Info\n\n```Text\nSystem:\n OS: macOS 15.5\n CPU: (14) arm64 Apple M4 Pro\n Memory: 218.33 MB / 48.00 GB\n Shell: 5.9 - /bin/zsh\n Binaries:\n Node: 22.16.0 - ~/.nvm/versions/node/v22.16.0/bin/node\n npm: 10.9.2 - ~/.nvm/versions/node/v22.16.0/bin/npm\n pnpm: 10.11.0 - /opt/homebrew/bin/pnpm\n Browsers:\n Chrome: 138.0.7204.159\n Safari: 18.5\n npmPackages:\n vitepress: ^1.6.3 => 1.6.3\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.",[3222],{"name":3146,"color":3147},4856,"vitepress not work for flowbite-vue","2025-07-25T10:13:26Z","https://github.com/vuejs/vitepress/issues/4856",0.66647637,{"description":3229,"labels":3230,"number":3232,"owner":3152,"repository":3153,"state":3165,"title":3233,"updated_at":3234,"url":3235,"score":3236},"### 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.",[3231],{"name":3146,"color":3147},349,"vitepress build x6 error","2023-01-21T16:22:15Z","https://github.com/vuejs/vitepress/issues/349",0.6700832,{"description":3238,"labels":3239,"number":3241,"owner":3152,"repository":3153,"state":3165,"title":3242,"updated_at":3243,"url":3244,"score":3245},"### Describe the bug\n\nIt is passed as `build.base` instead of root level `base` option\r\n\r\n```log\r\n\"build.base\" option is deprecated. \"base\" is now a root-level config option.\r\n```\n\n### Reproduction\n\nN/A\n\n### Expected behavior\n\nNo warning and work\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 13.0\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 3.91 GB / 64.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.1 - ~/Library/Caches/fnm_multishells/985_1655820447617/bin/node\r\n Yarn: 1.22.19 - ~/Library/Caches/fnm_multishells/985_1655820447617/bin/yarn\r\n npm: 8.12.1 - ~/Library/Caches/fnm_multishells/985_1655820447617/bin/npm\r\n Browsers:\r\n Chrome: 102.0.5005.115\r\n Firefox: 101.0.1\r\n Safari: 16.0\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.2 => 1.0.0-alpha.2\n```\n\n\n### Additional context\n\nWorking on a fix.\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.",[3240],{"name":3146,"color":3147},835,"`vitepress build docs --base /xxx/` does not work as expected","2023-01-21T14:34:00Z","https://github.com/vuejs/vitepress/issues/835",0.6733192,["Reactive",3247],{},["Set"],["ShallowReactive",3250],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fG3S0Hkt0HIZboIS4Nx0K84vLZV5SCA3SIqbiQpLZj90":-1},"/vuejs/vitepress/4261"]