🧭 高质量飞行模拟导航数据 - 为 PMDG、iniBuilds、X-Plane、iFly、TFDI 等插件提供数据支持
Nav-data 是一个由航空爱好者共同维护的开源数据转换项目，致力于为各类飞行模拟器（Microsoft Flight Simulator、X-Plane 等）提供高质量、实时更新的导航数据支持。我们专注于确保数据的准确性、时效性和兼容性，为飞行模拟爱好者提供最优质的飞行体验。
- 📦 多插件支持 - 支持 PMDG、iniBuilds、X-Plane、iFly、TFDI 等主流飞行模拟器插件
- 🛫 详细指南 - 提供完整的配置、安装与使用指南，包含故障排除
- 🗂️ 数据结构清晰 - 易于扩展与维护的数据结构，支持自定义配置
- 🤝 社区协作 - 开源项目，欢迎社区贡献与协作
- 🔍 全文搜索 - 支持中文全文搜索功能，快速找到所需信息
- 📱 响应式设计 - 完美适配桌面和移动设备
- 🔄 定期更新 - 数据源定期同步，确保信息准确性
- 🌐 多语言支持 - 支持中英文文档
- 📊 图表支持 - 集成 Mermaid，支持流程图和架构图
- ⚡ 快速部署 - 基于 VitePress，构建和部署速度极快
访问我们的在线文档：https://docs-ruddy-beta.vercel.app/
- 操作系统: Windows 10/11, macOS 11.0+, Ubuntu 20.04+
- Node.js: >= 18.0.0 (支持最新 LTS)
- 包管理器: npm >= 9.0.0, yarn >= 3.0.0, 或 pnpm >= 8.0.0
- 内存: 最少 4GB RAM
- 磁盘空间: 至少 1GB 可用空间
- Node.js: 最新 LTS 版本 (22.x)
- 包管理器: pnpm (最快) 或 npm 最新版本
- 内存: 8GB+ RAM（更好的构建性能）
- 磁盘空间: 2GB+ 可用空间（包含缓存）
- 网络: 稳定的互联网连接（用于依赖下载）
- 现代浏览器: Chrome 90+, Firefox 90+, Safari 14+, Edge 90+
- 移动浏览器: iOS Safari 14+, Chrome Mobile 90+
git clone https://github.com/nav-data/docs.git
cd docs# 使用 pnpm（最快、最高效）
pnpm install# 使用 npm
npm install
# 使用 yarn
yarn install💡 提示: 推荐使用 pnpm 获得更快的安装速度和更好的磁盘空间利用率
# 启动开发服务器（支持热重载）
pnpm dev # 推荐使用 pnpm
# 或
npm run dev
# 或
yarn dev
# 开发服务器将在 http://localhost:5173 启动# 使用自定义端口启动
pnpm dev --port 3000
# 或
npm run dev -- --port 3000# 构建生产版本
pnpm build # 推荐使用 pnpm
# 或
npm run build
# 或
yarn build# 预览构建结果
pnpm preview # 端口 4173
# 或
npm run preview
# 或
yarn preview
# 使用自定义端口预览
pnpm preview --port 8080📋 点击查看常见安装问题
# 检查 Node.js 版本
node --version
npm --version
# 推荐使用 Node 版本管理器
# fnm (快速替代 nvm)
curl -fsSL https://fnm.vercel.app/install | bash
fnm install --lts
fnm use lts-latest
# 或使用传统 nvm (Linux/macOS)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts
nvm use --lts
# Windows 用户推荐使用 nvm-windows
# 从 https://github.com/coreybutler/nvm-windows/releases 下载安装# 方案 1: 清理并重新安装 (pnpm)
pnpm store prune
rm -rf node_modules pnpm-lock.yaml
pnpm install
# 方案 2: 清理并重新安装 (npm)
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
# 方案 3: 使用不同的镜像源
npm config set registry https://registry.npmmirror.com
# 或
pnpm config set registry https://registry.npmmirror.com# 查看端口使用情况
# macOS/Linux
lsof -i :5173
# Windows
netstat -ano | findstr :5173
# 终止占用端口的进程或使用不同端口
pnpm dev --port 3000
# 或
npm run dev -- --port 3000# 方案 1: 修复 npm 权限（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile
# 方案 2: 使用 pnpm（避免权限问题）
curl -fsSL https://get.pnpm.io/install.sh | sh -
# 方案 3: 临时解决方案
sudo chown -R $(whoami) ~/.npm# 清理构建缓存
rm -rf docs/.vitepress/dist docs/.vitepress/cache
# 检查 Node.js 内存限制
node --max-old-space-size=4096 ./node_modules/.bin/vitepress build docs
# 检查文件权限
chmod -R 755 docs/开发服务器支持热重载，修改文档后会自动刷新页面：
- 📝 编辑 Markdown 文件即可实时预览
- 🎨 修改样式和配置会自动重新构建
- 🔍 内置搜索功能支持中文检索
生产构建会生成优化后的静态文件：
- 📦 代码分割和压缩
- 🖼️ 图片优化
- 🚀 Service Worker 支持
- 📱 PWA 功能
我们欢迎任何形式的贡献！
| 类型 | 说明 | 示例 |
|---|---|---|
| 🐛 Bug 修复 | 修复文档错误或功能问题 | 修复链接错误、更正信息 |
| 💡 功能建议 | 提出新功能或改进建议 | 新的插件支持、界面优化 |
| 📝 文档改进 | 改进现有文档或添加新内容 | 完善安装指南、添加示例 |
| 💻 代码贡献 | 修复问题或实现新功能 | 新功能开发、性能优化 |
| 🌐 翻译 | 提供多语言支持 | 英文翻译、其他语言支持 |
# Fork 仓库并克隆到本地
git clone https://github.com/Nav-data/docs.git
cd docs
# 添加上游仓库
git remote add upstream https://github.com/nav-data/docs.git
# 创建开发分支
git checkout -b feature/your-feature-name# 安装依赖
npm install
# 启动开发服务器
npm run dev
# 进行您的修改...
# 测试构建
npm run build# 添加修改
git add .
# 提交修改（请使用有意义的提交信息）
git commit -m "feat: add X-Plane installation guide"
# 推送到您的 Fork
git push origin feature/your-feature-name- 访问 GitHub 仓库页面
- 点击 "Compare & pull request"
- 填写详细的 PR 描述
- 等待代码审查
- 语言: 主要使用中文，重要术语可标注英文
- 格式: 遵循 Markdown 规范，使用一致的标题层级
- 图片: 优化图片大小，使用 WebP 格式
- 链接: 使用相对路径，确保链接有效
- 提交信息: 使用 Conventional Commits 规范
- 分支命名:
feature/功能名称或fix/问题描述 - 测试: 确保所有更改都经过测试
- 📋 清晰的标题和描述
- 🔗 相关 Issue 链接（如果有）
- ✅ 通过所有检查
- 📸 必要时提供截图
详细的贡献指南请查看：如何加入我们
| 插件 | 安装指南 | 配置文档 | 使用教程 | 常见问题 |
|---|---|---|---|---|
| 🚀 PMDG | 📥 安装 | ⚙️ 配置 | 📖 使用 | ❓ FAQ |
| 🏗️ iniBuilds | 📥 安装 | ⚙️ 配置 | 📖 使用 | ❓ FAQ |
| 📥 安装 | ⚙️ 配置 | 📖 使用 | ❓ FAQ | |
| 🛩️ iFly | 📥 安装 | ⚙️ 配置 | 📖 使用 | ❓ FAQ |
| 🎯 TFDI | 📥 安装 | ⚙️ 配置 | 📖 使用 | ❓ FAQ |
{
"navigation": {
"provider": "nav-data",
"version": "latest",
"update_interval": "weekly"
},
"plugins": {
"pmdg": {
"enabled": true,
"auto_update": true
},
"inibuilds": {
"enabled": true,
"custom_config": "/path/to/config"
},
"xplane": {
"enabled": false
},
"ifly": {
"enabled": true,
"compatibility_mode": "enhanced"
},
"tfdi": {
"enabled": true,
"advanced_features": true
}
}
}# 导航数据配置
nav_data:
source: 'official'
format: 'latest'
regions:
- 'ASIA'
- 'EUROPE'
- 'AMERICA'
# 插件特定配置
plugins:
pmdg:
aircraft_support:
- '737'
- '777'
- '747'
features:
waypoints: true
airways: true
procedures: true
inibuilds:
compatibility_mode: 'enhanced'
custom_procedures: true
ifly:
aircraft_support:
- '737'
- '787'
features:
navigation: true
performance: true
tfdi:
precision_mode: true
real_time_updates: true
custom_liveries: trueNav-data 支持多种数据格式：
| 格式 | 描述 | 用途 |
|---|---|---|
| JSON | 结构化数据格式 | API 接口、配置文件 |
| XML | 标准航空数据格式 | AIRAC 数据交换 |
| CSV | 表格数据格式 | 数据分析、导入导出 |
| Binary | 二进制格式 | 高性能数据加载 |
- 📦 框架: VitePress ^1.6.3 - 基于 Vite 和 Vue 3 的静态站点生成器
- 💻 语言: TypeScript/JavaScript + Markdown
- 📊 图表: Mermaid ^11.9.0 - 支持流程图和图表渲染
- 🚀 部署: GitHub Pages
- 🔍 搜索: VitePress 内置本地搜索
- 🎨 样式: CSS3 + 响应式设计
- ⚡ 构建工具: Vite - 极速构建和热重载
- 🌐 PWA: 渐进式 Web 应用支持
Nav-data/docs/
├── 📁 docs/ # 文档根目录
│ ├── 📁 Introduction/ # 项目介绍
│ │ ├── 📄 about.md # 关于我们
│ │ └── 📄 join.md # 如何加入
│ ├── 🚀 PMDG/ # PMDG 相关文档
│ │ ├── 📁 guide/ # 使用指南
│ │ │ ├── 📄 installation.md # 安装指南
│ │ │ ├── 📄 configuration.md # 配置说明
│ │ │ └── 📄 usage.md # 使用说明
│ │ ├── 📄 architecture.md # 架构说明
│ │ ├── 📄 changelog.md # 更新日志
│ │ ├── 📄 contributing.md # 贡献指南
│ │ ├── 📄 faq.md # 常见问题
│ │ ├── 📄 license.md # 许可证
│ │ └── 📄 troubleshooting.md # 故障排除
│ ├── 🏗️ iniBuilds/ # iniBuilds 相关文档
│ │ ├── 📁 guide/ # 使用指南
│ │ ├── 📄 architecture.md # 架构说明
│ │ └── 📄 ... # 其他文档
│ ├── ✈️ X-Plane/ # X-Plane 相关文档
│ │ ├── 📁 guide/ # 使用指南
│ │ ├── 📄 architecture.md # 架构说明
│ │ └── 📄 ... # 其他文档
│ ├── 🛩️ iFly/ # iFly 相关文档
│ │ ├── 📁 guide/ # 使用指南
│ │ ├── 📄 architecture.md # 架构说明
│ │ ├── 📄 changelog.md # 更新日志
│ │ ├── 📄 faq.md # 常见问题
│ │ └── 📄 ... # 其他文档
│ ├── 🎯 TFDI/ # TFDI 相关文档
│ │ ├── 📁 guide/ # 使用指南
│ │ ├── 📄 architecture.md # 架构说明
│ │ ├── 📄 changelog.md # 更新日志
│ │ ├── 📄 faq.md # 常见问题
│ │ └── 📄 ... # 其他文档
│ ├── 📁 public/ # 静态资源
│ │ ├── 🌐 favicon.svg # 网站图标
│ │ ├── 📱 manifest.json # PWA 配置
│ │ └── 🖼️ og-image.png # 社交媒体预览图
│ └── 📄 index.md # 首页
├── 📦 package.json # 项目配置和依赖
├── 🔒 package-lock.json # 依赖锁定文件
└── 📖 README.md # 项目说明（本文件）
本项目的导航数据来源包括：
- 官方数据库 - ICAO、FAA 等官方航空数据
- 开源数据集 - OpenStreetMap、OurAirports 等
- 社区贡献 - 飞行模拟器社区验证的数据
- 实时更新 - 定期同步最新的航空信息
| 更新类型 | 频率 | 说明 |
|---|---|---|
| 🗓️ 常规更新 | 每月一次 | 定期同步最新航空数据 |
| 🚨 紧急修复 | 24小时内 | 重要问题和安全修复 |
| 🚀 功能更新 | 按需发布 | 根据社区需求和反馈 |
| 📊 数据同步 | 每周一次 | 同步官方数据库更新 |
🚫 页面无法加载
问题: 访问文档网站时页面显示错误
解决方案:
- 检查网络连接
- 尝试刷新页面 (Ctrl+F5)
- 清除浏览器缓存
- 尝试使用其他浏览器
🔍 搜索功能不工作
问题: 搜索框无法正常工作或搜索结果为空
解决方案:
- 确保 JavaScript 已启用
- 尝试使用不同的关键词
- 检查浏览器控制台错误信息
- 刷新页面重新加载搜索索引
📱 移动端显示异常
问题: 在移动设备上页面显示不正确
解决方案:
- 确保使用最新版本的移动浏览器
- 检查网络连接稳定性
- 尝试横屏查看
- 清除移动浏览器缓存
⬇️ 文件下载失败
问题: 无法下载导航数据文件
解决方案:
- 检查文件链接是否有效
- 尝试右键"另存为"
- 使用下载管理器
- 联系维护团队
如果以上方法都无法解决问题：
- 📧 邮件联系: epa6643@gmail.com
- 🐛 提交 Issue: GitHub Issues
- 💬 社区讨论: GitHub Discussions
- 📖 查看文档: 故障排除页面
- GitHub Issues: 提交问题或建议
- GitHub Discussions: 社区讨论
- 邮箱: epa6643@gmail.com
本项目基于 MIT 许可证 开源。
感谢所有为本项目做出贡献的开发者和航空爱好者！
 Justin 项目发起人 & 核心开发 |
 Yuzuriha 数据维护 & 质量保证 |
| 合作伙伴 | 贡献 | 状态 |
|---|---|---|
| 🚀 PMDG Simulations | 优秀的飞行模拟器插件 | ✅ 官方支持 |
| 🏗️ iniBuilds | 高质量的航空器模型 | ✅ 官方支持 |
| 🛩️ iFly | 专业级航空器模拟 | ✅ 合作伙伴 |
| 🎯 TFDI Design | 精细化航空器开发 | ✅ 合作伙伴 |
| ⚡ VitePress | 强大的文档生成工具 | ✅ 技术支持 |
| 🌐 GitHub | 代码托管和协作平台 | ✅ 基础设施 |
如果这个项目对你有帮助，请给我们一个 Star！
关注我们的社交媒体获取最新动态
🎯 项目路线图
查看我们的 项目路线图 了解未来计划
💖 支持项目
如果您觉得这个项目对您有帮助，可以通过以下方式支持我们：
📞 快速联系
- 🐛 GitHub Issues: 提交问题或建议
- 💬 GitHub Discussions: 社区讨论
- 📧 邮箱联系: epa6643@gmail.com
- 📚 在线文档: https://nav-data.github.io/docs
Built with ❤️ by the Nav-data team • © 2025 Nav-data Project • Powered by VitePress