如何将GitLab Wiki合并至主代码仓库或实现同功能？

方案1：用Git子模块关联Wiki到主仓库的wiki/目录 #

GitLab Wiki本身是独立仓库，你可以把它作为子模块嵌入主仓库，兼顾Web端Wiki的结构化浏览和主仓库的文件同步：

• 本地克隆主代码仓库
• 在主仓库目录执行命令，添加Wiki为子模块（Wiki仓库地址从GitLab Wiki页面的「克隆仓库」按钮获取）：

  git submodule add git@gitlab.com:<用户名>/<项目名>.wiki.git wiki
  

• 提交并推送变更：

  git add .gitmodules wiki
  git commit -m "关联Wiki仓库为子模块"
  git push
  

后续Web端Wiki更新后，进入本地wiki/目录拉取更新，再提交主仓库的子模块版本变更即可同步。其他人克隆主仓库时，需要加--recurse-submodules参数，或者克隆后执行git submodule update --init获取Wiki内容。

方案2：用GitLab CI/CD自动同步Wiki到主仓库 #

如果不想手动维护子模块，可通过CI/CD自动把Wiki内容同步到主仓库的wiki/文件夹：

• 在主仓库根目录创建.gitlab-ci.yml，示例内容：

  sync-wiki:
    stage: deploy
    script:
      - git clone git@gitlab.com:<用户名>/<项目名>.wiki.git temp-wiki
      - rm -rf wiki
      - mv temp-wiki wiki
      - git config user.name "GitLab CI/CD"
      - git config user.email "ci@gitlab.com"
      - git add wiki
      - git commit -m "同步Wiki内容" || echo "无内容需要同步"
      - git push
    only:
      - schedules  # 定时触发，比如每天同步一次
      - web         # 支持手动触发
  

• 在GitLab项目的「CI/CD」→「流水线调度」中设置定时任务，就能自动同步Web端编辑的Wiki内容到主仓库。

方案3：直接在主仓库维护wiki/目录，用静态站点工具实现Web端浏览 #

放弃GitLab自带的独立Wiki仓库，直接在主仓库的wiki/目录下写.md文档，再通过以下方式实现Web端结构化浏览：

• 用MkDocs、VuePress等静态站点生成器，把wiki/目录编译成带导航的静态网站，部署到GitLab Pages上，获得和Wiki一致的浏览体验。
• 启用GitLab项目的「文档」功能，指定wiki/目录作为文档源，也能在Web端直接浏览结构化的文档。

内容的提问来源于stack exchange，提问作者LonLon