🔧

Mac 開発環境構築 #1

2024/02/02に公開

初心者

macOS

初期設定

tech

はじめに

macOSにおける開発環境の基礎を振り返る📝

Terminalのプロンプト改良（少しだけ）
パッケージマネージャの導入
Gitの設定（GitHub連携を含む）

今回は様々な開発環境下でも必須となるであろう上記3点を扱う。

動作環境

MacBook Air (M1, 2020) - macOS Sonoma 14.3
zsh 5.9 (x86_64-apple-darwin23.0)

Zsh (Z shell)

まずはshellの設定ファイルを少し弄ります。最近のMacではZshがデフォルトです。

設定

ホームディレクトリに設定ファイルを作成する。
terminal
```
touch ~/.zshrc
```
テキストエディタでファイルを開く。
terminal
```
open -e ~/.zshrc
# or
# vim ~/.zshrc
```
vimコマンドを使用してTerminal内で完結させるとクールですよね😎

以下のテキストを貼り付けて編集する。

~/.zshrc

#----------------------------------------------------------
# prompt
#----------------------------------------------------------
prompt() {
    PROMPT="%B%F{062}%d%f%b"
    PROMPT+=""$'\n'"%(?.%F{041}.%F{160})%n%# %f"
}
newline() {
    if [[ -z $PS1_NEWLINE_LOGIN ]]; then
      PS1_NEWLINE_LOGIN=true
    else
      printf '\n'
    fi
}

precmd() {
    prompt
    newline
}

実際にTerminalを再起動すると以下のような表示に変わります。
コマンドがエラー（終了ステータスが0以外）になるとユーザ名が赤色に変わります。

Add new SSH Key
ユーザ名は隠しています✌️

ここでは、プロンプトを少しだけ弄りました。
私はもう少しこだわったものを利用していますが、ここでは最小限に抑えます。
(おもしろいので自身で探ってみてほしい...🥺)

Homebrew

次にパッケージマネージャを導入します。
とても簡単です。ビール飲みたくなるね🍻

導入手順

Terminalで以下のコマンドを入力する。
terminal
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
!

途中でEnterの入力が要求される可能性があるのでその際は押します。
パスコードを求められる場合もあるので入力してください。
インストールできているか確認する。
Terminalを再起動して以下のコマンドを入力する。
terminal
```
brew -v
```
output example
```
Homebrew 4.2.6
```
output exampleのような出力が得られていれば成功です。
（手順3と手順4は飛ばしてOK👌）
確認ができなければパスを通す。
terminal
```
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/$USERNAME/.zprofile
```
!

$USERNAMEには自身のユーザ名が入ります。
再度、インストールできているか確認する。
Terminalを再起動して以下のコマンドを入力する。
terminal
```
brew -v
```
output example
```
Homebrew 4.2.6
```

Homebrewを使えば、様々なツールが手軽に扱えるようになります。
GitHub等で興味が湧いたツールを実際にインストールして使用してみるとおもしろいですよ🤤

Git

こちらが有名なGitです。作った人すごい👏

導入手順

さきほど導入したHomebrewを使用してインストールする。
terminal
```
brew install git
```

インストールできているか確認する。

terminal

brew info git

output example

==> git: stable 2.43.0 (bottled), HEAD
Distributed revision control system
...

設定 (GitHub連携を含む)

GitHubのアカウント登録は済んでいる前提で以降の操作は行います。
アカウント登録が済んでいない場合はすぐに登録しましょう🫵

.gitconfig(global)の設定

識別情報の設定を行う。
terminal
```
git config --global user.name $USERNAME
git config --global user.email ID+USERNAME@users.noreply.github.com
```
!

・$USERNAMEには自身のユーザ名が入ります。

・ID+USERNAME@users.noreply.github.comは
　GitHubのメール設定で確認できるものを使用します。
必要に応じてgitconfigを編集する。
~/.gitconfig
```
[user]
  name = $USERNAME
  email = ID+USERNAME@users.noreply.github.com
...
```
~/.gitconfigを編集することでユーザ単位の設定が可能です。
他にもローカル（リポジトリ）単位やシステム単位で設定することも可能ですがここでは扱いません。開発環境やチームの方針に沿って設定する必要があります。

SSH-key設定

GitHubが公開しているドキュメントを参考に進めていきます🗝️

SSH-keyを生成する。
terminal
```
ssh-keygen -t ed25519 -C $YOUR_EMAIL
```
!

・$YOUR_EMAILには自身のメールアドレスが入ります。

・途中でEnterの入力が要求されるのでその際は押します。
　デフォルトでは、/Users/$USERNAME/.sshに鍵が配置されます。
SSH-keyを確認する。
terminal
```
cd ~/.ssh
ls
```
output example
```
config  id_ed25519  id_ed25519.pub  ...
```
秘密鍵id_ed25519と公開鍵id_ed25519.pubが生成されています。

!

秘密鍵はどこにも漏らさないように...！！！！　ダメ絶対！！！！！
公開鍵をコピーする。
terminal
```
pbcopy < ~/.ssh/id_ed25519.pub
```
GitHubに公開鍵を渡す。
GitHubのkey設定にアクセスし、[New SHH key]をクリックする。

このような画面が表示される
```
Title:      お好きなもの
Key type:   Authentication Key
Key:        手順3でコピーしたものを貼り付ける
```
入力を終えたら、[Add SHH key]をクリックして完了です。
接続テストを行う。
terminal
```
ssh -T git@github.com
```
output example
```
Hi $GITHUB_USERNAME You've successfully authenticated, but GitHub does not provide shell access.
```
私はすでに接続を確認しているので、output exampleと同じ出力を受け取ります。
しかし、はじめて接続した場合にはもう少し長い出力を受け取ります。何度かEnterやyesの入力を求められるので応じてください。

おわりに

お疲れ様でした。これにて、Macの開発環境のベースは整ったと思います。
これからは自らの開発環境に合わせてHomebrewやGitを活かしていきましょう👋

GitHubで編集を提案

はじめに

動作環境

Zsh (Z shell)

設定

Homebrew

導入手順

Git

導入手順

設定 (GitHub連携を含む)

.gitconfig(global)の設定

SSH-key設定

おわりに

Discussion