Github Codespaces中Docusaurus项目实时预览无法正常工作

安全阿岳

2026-8-14

Docusaurus 在 GitHub Codespaces 中路由转发异常的解决办法

调整项目配置
打开docusaurus.config.js，添加或修改host和port配置，让项目监听所有网络接口，适配Codespaces环境：
```
module.exports = {
  // 保留原有其他配置
  host: '0.0.0.0',
  port: 3000,
}
```
带参数启动项目
不想改配置的话，直接在启动命令后追加参数，强制指定监听地址：
```
npm start -- --host 0.0.0.0 --port 3000
```
检查端口转发状态
确认Codespaces里的端口3000已被正确转发，状态为活跃，根据需求设置访问权限（公开/私有），避免端口被拦截导致路由无法访问。
清理缓存重启
缓存可能引发路由异常，执行以下命令清理后重新启动：
```
npm run clear
npm start -- --host 0.0.0.0
```