uni-app 内置的web服务器不能正确的渲染docsify文档

uni-app 内置的web服务器不能正确的渲染docsify文档

信息类别 内容
产品分类 HbuilderX
操作系统 Windows
操作系统版本 20H2
HBuilderX版本 3.1.22

bug描述：

内置的web服务器对docsify文档不能正确渲染，改用外部web服务器又不能进行动态根路径渲染，报错如下：

图片

操作步骤：

无

预期结果：

正常

实际结果：

不正常


更多关于uni-app 内置的web服务器不能正确的渲染docsify文档的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

正确结果：

更多关于uni-app 内置的web服务器不能正确的渲染docsify文档的实战教程也可以访问 https://www.itying.com/category-93-b0.html


期望点击浏览器预览按钮时，能正确渲染index.html文件，不然每次都需要去配置nginx

在 uni-app 的内置 web 服务器中渲染 docsify 文档时，由于服务器对前端路由和历史模式的支持限制，可能导致渲染失败。docsify 依赖 HTML5 History API 进行路由管理，而内置服务器默认配置可能未完全适配此类 SPA 应用。

解决方案：

  1. 检查 docsify 配置：确保在 index.html 中正确设置 basePath，并配置 routerMode: 'history'。示例：
    window.$docsify = {
  basePath: '/your-project-path/',
  routerMode: 'history'
}
  2. 配置 HBuilderX 服务器：在项目 manifest.json 的 “h5” 部分添加 router 配置，启用 history 模式：
    "h5": {
  "router": {
    "mode": "history"
  }
}
回到顶部