【Github】GitHubのユーザー名の変更

:::note alert
この記事の内容は **2025/02/07** 時点での操作になっております。予めご了承ください。
:::

# はじめに
* 本当に悪気なく付けた Github の username をカジュアル面談時に触れられて大変困ったため変更を決意

# "username"とは？ "Name"との違いは？

:::note info
* `username` ... **一意**　リポジトリなどを特定するための URL に使用されるため
* `name` ... 重複可　Github上のニックネーム
:::

```:例）username と URL
https://github.com/[username]/[リポジトリ名]
```
* このように "username" の方は URL に使用される

（水色線："username" ／ 黄色線："name"）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/7daf00a6-7327-4eb6-0a22-637961b88c0e.png)

（水色線："username" ／ 黄色線："name"）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/3816ea0c-103e-0142-2d74-51879e111019.png)


# 手順
## (1) 設定より "username" の変更
### 1. "Setteings"を開く
* 右上にある自分のアイコンを押下して表示されるメニューより"Settings"を押下

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/d00daf5f-2ec5-e387-aa07-7d2c1a4b25c9.png)


### 2. "Change username"を押下
* "Account > Change username"の項目を確認できるので、"Change username"ボタンを押下

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/e007b83e-0281-24ff-cfff-9b7dba4fe4e5.png)

:::note warn
* 先述の通り、"Public profile > Name" と "username" は違います

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/61d08013-6daf-0f40-f097-d296676959de.png)
:::


### 3. 新しい"username"に更新
* 以下のような注意書きを確認後、下にある同意ボタンを押下
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/2af4425a-e480-c2b9-b337-5ce202c9892a.png)

* 一意となる "username" を入力してボタンを押下する

(以下のように既に使用されている "username" は命名不可)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/b3d4b21e-8f68-4fed-ef0f-75c055fc8978.png)


## 4. 念のため変更を確認
* 適当な自分のリポジトリを開き URL を確認
URL に新しい "username" が確認できればOK

```:例）username と URL
https://github.com/[新しいusername]/[リポジトリ名]
```


## (2) ローカルの "username" の変更
### 1. 'git config'の確認及び変更
```:ローカルの設定の確認
$ git config --global -l

user.name=[変更前の"username"]
user.email=[メールアドレス]
```
```:ローカルの設定の変更
$ git config --global user.name '[新しい"username"]'
```
<font color="Red">※シングルクォーテーションで囲んでください</font>

### 2. 'git remote'の確認及び変更
```:ローカルの設定の確認
$ git remote -v

origin git@github.com:[変更前の"username"]/[リポジトリ名].git (fetch)
origin git@github.com:[変更前の"username"]/[リポジトリ名].git (push)
```

* 対象のリポジトリの URL を取得して、後述の[コピーした URL]として使用する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3518714/c25aa37d-41bd-901a-8d69-9bfa72168243.png)


```:ローカルの設定の変更
$ git remote set-url origin [コピーした URL]
```
* `git@github.com:[新しい"username"]/[リポジトリ名].git` のような URL であれば問題ありません

<font color="Red">※リポジトリの数だけこの手順が必要なので留意してください</font>


# 注意点
## 1. プロフィールページ用のリポジトリ名を変更
* Github のプロフィールページをアレンジしている方は "username" の変更に伴って**ユーザー名と同じ名前のリポジトリの変更が必要**になります


## 2. 汎用的な名前のリポジトリがある場合は注意

https://qiita.com/aiandrox/items/d1c19ffabad7b8cc187a

* こちらの記事より、汎用的な名称のリポジトリを保持している場合にエラーになるケースがあるようです


---
### 参考資料

https://qiita.com/plant0322/items/c278ef6d42d096714aa9

https://kakakakakku.hatenablog.com/entry/2016/01/03/002601

https://docs.github.com/ja/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/changing-your-github-username

https://dangerous-animal141.hatenablog.com/entry/2014/05/05/000000

https://qiita.com/aiandrox/items/d1c19ffabad7b8cc187a