環境構築

GitHub Pagesで404が表示される

Pages設定またはindex.htmlの配置が間違っている

こんな症状

GitHub Pagesで公開したのに404エラーが表示される。GitHub Pagesの設定で起きやすいよ。

まず試す

Settings→Pages→Source を main / (root) にし、index.html をリポジトリ直下に置いて push する。

env

# index.html をルートへ移動して公開
git mv src/index.html index.html
git commit -m "index.htmlをルートに移動"
git push origin main

これで直らなければ、下の「自分のケース」を確認。

🔍 自分のケースはどれ？

✓Settings→Pages の Source が None のまま
→ Source でブランチ(main)とフォルダ(/ root)を選んで Save する。
✓index.html が docs/ や src/ にある
→ index.html をリポジトリ直下（ルート）に置く。
✓公開したばかり
→ 反映に数分かかる。少し待って再アクセスする。

なぜ起きる？

リポジトリのSettings > PagesでSourceが設定されていない、またはindex.htmlがルートにないよ。GitHub Pagesは指定したブランチの指定したフォルダからファイルを配信するんだ。設定が正しくないとファイルが見つからず404になるよ。

✕ エラーが起きるコード

# https://ユーザー名.github.io/リポジトリ名/ を開くと
# 404 There isn't a GitHub Pages site here.

# よくある状態:
# ・Settings → Pages の Source が「None」のまま
# ・index.html が docs/ や src/ の中にあってルートにない

✓ 直したコード

# 1. リポジトリの Settings → Pages → Branch を main / (root) にして Save
# 2. index.html をリポジトリ直下に置く
$ git mv src/index.html index.html
$ git commit -m 'index.htmlをルートに移動'
$ git push origin main
# 3. 数分待ってから再アクセス（反映には時間がかかる）