ファイル名を変更する

リポジトリ内の任意のファイルは、GitHub で直接、またはコマンド ラインを使って名前を変更することができます。

Platform navigation

この記事の内容

GitHub

のファイル名を変更する

ファイル名を変更すると、ファイルを新しい場所に移動することもできます。

Tip

  • アクセスのないリポジトリにあるファイルの名前を変更しようとした場合は、変更をコミットした後に、プロジェクトが個人アカウントへフォークされ、pull request を元のリポジトリへ送信できるようになります。
  • Web インターフェイスを介して作成されるファイル名では英数字とハイフン (-) しか使用できません。 それ以外の文字を使用するには、ファイルをローカルで作成してコミットしてから、リポジトリへプッシュします。
  • 一部のファイル (画像など) は、コマンドラインで名前を変更することが要求されます。 詳細については、「コマンド ラインを使用してファイル名を変更する」を参照してください。

  1. リポジトリで、名前を変更するファイルを見つけます。

  2. ファイル ビューの右上隅にある をクリックしてファイル エディターを開きます。

    ファイルのスクリーンショット。 ヘッダーにある鉛筆アイコンのラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

  3. ファイル名フィールドで、ファイルの名前を新しいファイル名に変更します。 ファイルのコンテンツも同時に更新できます。

    Web ブラウザーで編集するためにリポジトリ ファイルを開いている場面のスクリーンショット。 ファイル名フィールドがアクティブになっており、濃いオレンジ色の枠線で囲まれています。

  4. [変更のコミット...] をクリックします。

  5. [コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」を参照してください。

  6. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」を参照してください。

    GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選ばれています。

  7. [変更のコミット] または [変更の提案] をクリックします。

コマンドラインを使用してファイルの名前を変更する

コマンドラインを使用して、リポジトリにあるファイルの名前を変更することができます。

多くのファイルは GitHub で直接名前を変更できますが、画像など一部のファイルは、コマンド ラインで名前を変更する必要があります。

この手順は、以下が済んでいることを前提としています。

  1. [ターミナル][ターミナル][Git Bash] を開きます。

  2. ワーキングディレクトリをローカルのリポジトリに変更します。

  3. 古いファイル名と、ファイルに付ける新しい名前を指定して、ファイルの名前を変更します。 これにより、変更がコミット向けにステージングされます。

    git mv OLD-FILENAME NEW-FILENAME

  4. git status を使用して、ファイルの古い名前と新しい名前をチェックします。

    $ git status
> # On branch YOUR-BRANCH
> # Changes to be committed:
> #   (use "git reset HEAD <file>..." to unstage)
> #
> #     renamed: OLD-FILENAME -> NEW-FILENAME
> #

  5. ローカルリポジトリでステージングしたファイルをコミットしてください。

    $ git commit -m "Rename file"
# Commits the tracked changes and prepares them to be pushed to a remote repository.
# このコミットを削除してファイルを変更するには、'git reset --soft HEAD~1'を使い、コミットしてからファイルを再度追加してください。

  6. GitHub.com にローカル リポジトリの変更をプッシュします。

    $ git push origin YOUR_BRANCH
# Pushes the changes in your local repository up to the remote repository you specified as the origin