React项目SRC代码未显示在GitHub Pages关联仓库的求助

1. 先理清分支问题 #

你当前的情况大概率是把GitHub Pages的构建产物直接推送到了仓库主分支，覆盖了原本的React源码。正常做法是用两个分支分开管理：一个分支（比如main/master）存完整的React源码，另一个分支（比如gh-pages）存构建后的部署文件。

2. 上传React源码到主分支 #

如果本地还保留着完整的React项目（包含src、package.json等文件），执行以下步骤：

• 打开项目终端，切换到主分支：

  git checkout main
  

• 把所有源码文件加入git追踪：

  git add .
  

• 提交更改：

  git commit -m "Add full React source code"
  

• 推送到远程仓库：

  git push origin main
  

完成后主分支就会显示src文件夹和所有React代码文件。

3. 调整GitHub Pages部署分支 #

为了避免以后再出现源码被覆盖的情况，建议把部署分支改成gh-pages：

• 本地先运行构建命令生成产物：

  npm run build
  

• 安装gh-pages工具（如果没装过）：

  npm install gh-pages --save-dev
  

• 在package.json里添加以下配置：

  "homepage": "https://faizanm0389.github.io/DD-APP",
  "scripts": {
    "predeploy": "npm run build",
    "deploy": "gh-pages -d build"
  }
  

• 执行部署命令，把构建产物推到gh-pages分支：

  npm run deploy
  

• 打开仓库的Settings → Pages页面，将部署分支切换为gh-pages并保存。

4. 应急：手动上传源码 #

如果本地没有源码备份，直接在GitHub仓库页面操作：点击顶部的"Add file" → "Upload files"，选择本地的src文件夹、package.json、README.md等源码文件上传即可。

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