# 常见问题

这里列出了使用文档站点时可能遇到的常见问题及其解答。

## 文档站点无法正常显示

**问题：** 访问 http://localhost:3000 后页面空白或显示错误。

**解决方法：**
- 确认服务器已成功启动（`npm run start`）
- 检查`index.html`中的`basePath`配置是否正确
- 确认`doc`目录下有`home.md`文件

## 侧边栏不显示

**问题：** 页面加载后没有显示侧边栏。

**解决方法：**
- 确认`index.html`中的`loadSidebar`配置为`true`
- 检查`doc`目录下是否存在`_sidebar.md`文件
- 确认`_sidebar.md`的格式是否正确

## 如何添加新的导航项

**问题：** 如何在侧边栏中添加新的导航项？

**解决方法：**
1. 在`doc`目录下创建新的Markdown文件
2. 在`_sidebar.md`中添加对应的链接，格式为 `* [页面标题](文件名.md)`

## 如何修改页面样式

**问题：** 如何修改文档页面的样式？

**解决方法：**
- 修改`css/vue.css`文件
- 或者在`index.html`中引入自定义的CSS文件

## 如何添加图片

**问题：** 如何在Markdown文件中添加图片？

**解决方法：**

1. 在`doc`目录下创建`images`文件夹
2. 将图片放入该文件夹
3. 在Markdown文件中使用相对路径引用，例如：

```markdown
![图片描述](images/example.png)
```