\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.",[3033],{"name":3034,"color":3035},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.6389571,{"description":3042,"labels":3043,"number":3045,"owner":3023,"repository":3024,"state":3025,"title":3046,"updated_at":3047,"url":3048,"score":3049},"### Describe the bug\n\nyarn docs:dev\r\n\r\nBrowser display error:\r\n\r\n\n\n### Reproduction\n\nFollow the getting started case, which is https://vitepress.vuejs.org/guide/getting-started.html\n\n### Expected behavior\n\nNormal display index.md\n\n### System Info\n\n```shell\n~~~\r\nPS G:\\vitePress> npx envinfo --system --npmPackages vitepress --binaries --browsers\r\nNeed to install the following packages:\r\n envinfo\r\nOk to proceed? (y) y\r\n\r\n System:\r\n OS: Windows 10 10.0.17763\r\n CPU: (8) x64 Intel(R) Xeon(R) CPU E3-1230 V2 @ 3.30GHz\r\n Memory: 3.91 GB / 7.93 GB\r\n Binaries:\r\n Node: 16.5.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.10 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 7.20.5 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 92.0.4515.107\r\n Edge: Spartan (44.17763.831.0)\r\n Internet Explorer: 11.0.17763.771\r\n npmPackages:\r\n vitepress: ^0.15.6 => 0.15.6\r\n~~~\n```\n\n\n### Additional context\n\n\r\n\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[3044],{"name":3020,"color":3021},359,"Using the simplest example, an error occurred","2023-01-21T16:22:13Z","https://github.com/vuejs/vitepress/issues/359",0.64370924,{"description":3051,"labels":3052,"number":3054,"owner":3023,"repository":3024,"state":3025,"title":3055,"updated_at":3056,"url":3057,"score":3058},"### 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.",[3053],{"name":3020,"color":3021},2089,"锚点链接中文错误","2023-03-23T00:04:21Z","https://github.com/vuejs/vitepress/issues/2089",0.6533193,{"description":3060,"labels":3061,"number":3063,"owner":3023,"repository":3024,"state":3025,"title":3064,"updated_at":3065,"url":3066,"score":3067},"### 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.",[3062],{"name":3020,"color":3021},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.6575944,{"description":3069,"labels":3070,"number":3072,"owner":3023,"repository":3024,"state":3025,"title":3073,"updated_at":3074,"url":3075,"score":3076},"### 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.",[3071],{"name":3020,"color":3021},2349,"热更新","2023-05-24T00:03:54Z","https://github.com/vuejs/vitepress/issues/2349",0.65999144,{"description":3078,"labels":3079,"number":3081,"owner":3023,"repository":3024,"state":3025,"title":3082,"updated_at":3083,"url":3084,"score":3085},"### Describe the bug\n\nI imported a lib which called document APIs. The minimized reproduction:\r\n\r\n```\r\n\u003Cscript>\r\nconst div = document.createElement('div');\r\nconsole.log(div)\r\n\u003C/script>\r\n\r\n# Hello World\r\n```\r\n\r\nIt works in vitepress dev but fails in vitepress build\n\n### Reproduction\n\nhttps://github.com/Jinjiang/reproductions/tree/vitepress-document-20240219\n\n### Expected behavior\n\nWorks as vitepress dev does\n\n### System Info\n\n```Text\n$ npx envinfo --system --npmPackages vitepress --binaries --browsers\r\n\r\n System:\r\n OS: macOS 14.4\r\n CPU: (8) arm64 Apple M1\r\n Memory: 75.17 MB / 8.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.1.0 - ~/.asdf/installs/nodejs/20.1.0/bin/node\r\n Yarn: 1.22.19 - ~/.asdf/shims/yarn\r\n npm: 9.6.4 - ~/.asdf/plugins/nodejs/shims/npm\r\n Browsers:\r\n Safari: 17.4\r\n npmPackages:\r\n vitepress: 1.0.0-rc.43 => 1.0.0-rc.43\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.",[3080],{"name":3020,"color":3021},3583,"document is not defined when vitepress build","2024-02-27T00:05:55Z","https://github.com/vuejs/vitepress/issues/3583",0.6606518,{"description":3087,"labels":3088,"number":3090,"owner":3023,"repository":3024,"state":3025,"title":3091,"updated_at":3092,"url":3093,"score":3094},"### Describe the bug\n\n\u003Cimg width=\"269\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/10622fbc-efb0-4dbd-a342-5c4e73ed04a0\">\r\n\u003Cimg width=\"1272\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/42577ef3-634d-459e-bf05-97ada3afef7b\">\r\n以前旧版本是没有这个问题的。升级后才有的。\n\n### Reproduction\n\n升级vitepress打包部署后出现的\n\n### Expected behavior\n\n望能修复正常\n\n### System Info\n\n```sh\nSystem:\r\n OS: macOS 13.4.1\r\n CPU: (8) arm64 Apple M1\r\n Memory: 57.69 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 16.14.0 - ~/.nvm/versions/node/v16.14.0/bin/node\r\n Yarn: 1.22.19 - ~/.nvm/versions/node/v16.14.0/bin/yarn\r\n npm: 9.8.0 - ~/.nvm/versions/node/v16.14.0/bin/npm\r\n Watchman: 2023.03.27.00 - /opt/homebrew/bin/watchman\r\n Browsers:\r\n Chrome: 115.0.5790.170\r\n Safari: 16.5.2\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.",[3089],{"name":3020,"color":3021},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.66130716,{"description":3096,"labels":3097,"number":3099,"owner":3023,"repository":3024,"state":3025,"title":3100,"updated_at":3101,"url":3102,"score":3103},"### Describe the bug\n\n我在使用自定义主题中, 给主题添加一个 i18n 功能, 是通过构建时数据加载方式进行加载的, 然后再 enhanceApp 中挂在一个全局的 `$t` 方法以便于在组件中方便设置 i18n 配置. 当然自定义主题文件放置在 `theme` 下时, 执行 dev 或者 build 时一切正常, 但是我将之定义主题发布到 npm 后, 通过 npm 安装引入后, 执行 dev 就会出现 ` No matching export in \"node_modules/vitepress-theme-async/composables/languages.data.ts\" for import \"data\"` 的错误 ,但是执行 build 是正常的.\n\n### Reproduction\n\n可以通过 `npm create async-theme@latest my-first-blog` 命令, 快速初始化一个可复现 demo \r\n\r\n\n\n### Expected behavior\n\n通过 npm 发布的主题包和将文件放置在 `theme` 下行为一致\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 Intel(R) Core(TM) i5-10400F CPU @ 2.90GHz\r\n Memory: 7.37 GB / 15.88 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\Program Files\\nodejs\\node.EXE \r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.5.1 - C:\\Program Files\\nodejs\\pnpm.CMD\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.",[3098],{"name":3020,"color":3021},3185,"Symptom When the npm package is used, Build-Time Data Loading is abnormal","2023-11-14T00:04:40Z","https://github.com/vuejs/vitepress/issues/3185",0.6622931,{"description":3105,"labels":3106,"number":3110,"owner":3023,"repository":3024,"state":3025,"title":3111,"updated_at":3112,"url":3113,"score":3114},"### Describe the bug\n\n我在使用 `createContentLoader()` 加载 Markdown 文件时,尝试通过 `!**/index.md` 和 `!**/*-ignore.md` 排除某些文件,但这些排除规则没有生效\n\n```ts\nexport default createContentLoader(\n [\n '**/*.md',\n '!**/*-ignore.md',\n '!**/index.md',\n ],\n)\n```\n\n直接使用 `tinyglobby ` 是正常的\n\n```ts\nimport { glob } from 'tinyglobby'\n\n\nglob(\n [\n '**/*.md',\n '!**/*-ignore.md',\n '!**/index.md',\n ],\n { cwd: 'docs' },\n).then((res) => {\n console.log(res.length)\n})\n\n```\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-createcontentloader?file=docs%2Ftest.data.js\n\n### Expected behavior\n\n正确的排除文件\n\n### System Info\n\n```Text\nSystem:\n OS: Windows 11 10.0.26120\n CPU: (32) x64 13th Gen Intel(R) Core(TM) i9-13980HX\n Memory: 35.99 GB / 63.63 GB\n Binaries:\n Node: 22.14.0 - C:\\Program Files\\nodejs\\node.EXE\n npm: 10.9.2 - C:\\Program Files\\nodejs\\npm.CMD\n pnpm: 10.11.0 - ~\\AppData\\Local\\pnpm\\pnpm.EXE\n Browsers:\n Edge: Chromium (134.0.3124.19)\n Internet Explorer: 11.0.26100.1\n npmPackages:\n vitepress: 2.0.0-alpha.6 => 2.0.0-alpha.6\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.",[3107],{"name":3108,"color":3109},"build","377ba8",4807,"createContentLoader() 排除文件的 glob 模式不生效","2025-06-23T16:28:40Z","https://github.com/vuejs/vitepress/issues/4807",0.6661349,["Reactive",3116],{},["Set"],["ShallowReactive",3119],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$f4cT7s82S-CR_2ZRXijL36MSvOOCtaoasURxZ07tD_k4":-1},"/vuejs/vitepress/2478"]