새로운 마음으로 시작하고 싶은 개발자들을 위한 작은 가이드 입니다. 백업부터 투철하게 하세요. AWS 인증키나 1password 백업파일, 기존에 사용하시던 설정(.zshrc, init.el, vscode 등...)은 어딘가(Dropbox or github)에 반드시 보관해 주세요. Dropbox 동기화가 최신으로 되어 있는지도 확인하세요. 포멧(Erase)은 돌아오지 않아요. 백업 및 클라우드에 모든 파일이 동기화 되셨나요? 이제 시작해보죠! - 2022.10.25

M1/M2 MacBook 사용자를 위한 당부의 말씀

저는 운영체제를 설치하는 것을 귀찮아 합니다. 그래서 새롭게 운영체제를 설치하거나 부득이한 사정으로 인해서 운영체제를 설정하는 경우 발생할 수 있는 오류를 최대한으로 줄이기 위해서 클린 설치(모든 것을 삭제하고 새롭게 설치하는 것)를 선호합니다. 그래서 macOS는 1년에 한 번 정도 OS를 새롭게 설치하고, 우분투는 거의 4년에.. 한번? 정도 새롭게 설치를 합니다. OS에 내장된 초기화 기능이 미덥지 않기 때문에 USB를 활용해서 설치를 진행합니다.

하지만, M1/M2가 장착된 기기의 경우 T2칩이 탑재되어 있기 때문에 '사과마크' > '시스템 환경설정' > '모든 콘텐츠 및 설정 지우기'를 통해서 간편하게 초기화가 가능합니다. 별도의 USB를 만들지 마시고, Ventura로 업데이트를 진행하시고 초기 설정까지 완료하세요. 그리고 '모든 콘텐츠 및 설정 지우기'를 활용하시면 Ventura가 설치된 환경에서 빠르게 초기화 가능합니다.

M1/M2의 경우 USB 설치시 발생할 수 있는 특이사항(하드웨어 인증)에 대체가 힘들 수 있으니 될 수 있으면 업데이트 이후 초기화를 선택하시길 권해드립니다. USB로 새로운 운영체제를 설치하는 건 Intel 하드웨어 기반의 macOS 사용자에게 권해드립니다.

Clean install을 위한 USB 만들기

macOS 다운로드

• Ventura를 App Store에서 다운로드 합니다.

• 다운로드가 완료되면, System Preferences > Software Update에서 확인할 수 있습니다.

• 다운로드가 완료되면 Ventura 설치 관련(Install macOS Ventura) 안내 페이지를 확인할 수 있는데, 해당 페이지를 실행하지 말고 닫아주세요(Quit Install macOS).

USB 준비

• 16기가 이상의 USB를 사용하세요. USB를 초기화하기 위해서 App > Other > Disk Utility를 실행해서, Disk Utility의 External 항목에 사용할 USB를 선택하시고 Erase를 선택해서 USB를 초기화 합니다.
  • USB의 Name은 'macOS-Installer'로 하였고, Format은 'Mac OS Extended (Journaled)'

• Terminal(혹은 iTerm2 등)을 실행하고 sudo /Applications/Install\ macOS\ Ventura.app/Contents/Resources/createinstallmedia --volume /Volumes/macOS-Installer/를 실행합니다. createinstallmedia에 관한 내용은 링크를 참고하세요.
  • sudo는 관리자 권한이 필요하단 뜻으로 해당 명령어를 실행하면 시스템의 비밀번호를 입력해야 합니다.
  • --volume은 USB의 경로(일반적으로 /Volumes/ 아래에 USB의 레이블명(Name)으로 존재합니다)를 적어줍니다.

USB를 사용해서 설치하기

Big Sur에서 USB Booting 관련 설정을 하셨다면 아래 USB 부팅 설정은 건너띄고 진행하셔도 됩니다. 만약 이번에 처음 USB로 설치를 진행하신다면 USB 부팅 설정을 확인하세요. 설치시 사용하는 키는 아래 이미지에서 확인하세요.

USB 부팅 설정

• 컴퓨터를 부팅할 때 복구모드 설정 키(Command + R)을 누르고 있으면 복구 모드로 진행됩니다. 이때, 사용하는 비밀번호는 현재 설치된 운영체제에서 사용하는 비밀번호 입니다. iCloud 관련 비번이 아니니 주의하세요.

• 복구모드에서 상단의 메뉴바를 선택하고 Utilities > Startup Security Utility를 선택 후, 기존에 사용하시던 macOS의 비밀번호를 입력하면, 옵션이 출력됩니다. 하단에 위치한 Allow booting from external or removable media를 선택하시고, 창을 닫은 후 사과마트를 눌러서 restart를 선택하세요.

USB 부팅

• 컴퓨터가 새로 시작될 때, Option 키 누르고 있으면, Boot Disk를 선택하는 화면에서 Install macOS Ventura를 선택하시면 됩니다. 만약 업데이트가 필요하다는 알림창이 안내된다면 업데이트를 진행하세요(A software update is required to use this startup key)

• Disk Utility를 사용해서 기존에 사용하던 디스크를 Erase를 하시고, Install macOS Ventura를 사용해서 설치하시면 됩니다.

• 설치 후 몇번의 재부팅이 되고 난 이후에, 그래픽 화면에서 중요 설정 사항을 입력하는 화면이 진행됩니다. 지역 및 iCloud 등은 안내에 맞춰서 진행하시면 됩니다.
  • 저는 개발 환경을 구성하기 기존의 데이터를 마이그레이션(Migration Assistant > Not Now) 하지 않았습니다. 기존에 데이터를 마이그레이션 하셔야 된다면 적절한 옵션을 선택하세요.

시스템 설정

제가 개인적으로 사용하는 시스템 설정입니다. 간략하게 해당 설정을 적용/미적용 하는 이유를 적어두었으니 참고하시면 좋을 듯 합니다.

시스템 설정(System Settings)

• General
  • About > Name은 iCloud에 표시될 기기이름 입니다.
  • Language & Region > Preferred Languages > 'English - Primary', 'Korean' 로 설정합니다. 개발 과정에서 오류 및 에러가 한글로 출력되지 않도록 하기 위해서 영어를 Primary로 설정하였습니다. 그리고 Translation Languages...에 필요한 언어를 추가해주세요.
  • Sharing의 hostname은 Terminal에 표시됩니다. 될 수 있으면 짧고 적당한(?) 것으로 변경하세요.
  • Date & Time, 24-hour time 등과 같이 자주 사용하시는 옵션을 선택하세요.

• Appearance > Dark

  • Dark를 선택하였습니다. 밝은색을 원하시면 Light를 선택하세요.

• Control Center

  • Wi-Fi, Bluetooth, Focus, Stage Manager, Sound를 매뉴바에서 항상 확인 할 수 있도록 선택하였습니다.

• Desktop & Dock

  • Show recent applications in Dock을 선택해지하였습니다. 최근 사용한 애플리케이션을 Dock에 표시하는 옵션으로 Dock이 복잡해지는 것을 좋아하지 않아서 사용하지 않습니다.
  • Mission Control > Automatically rearrange Spaces based on most recent use의 선택을 해제합니다. Space를 변경할 때, 최근에 사용된 Space를 중심으로 배치되는데 개발할 때 좌우 Space를 고정해서 사용하는 것을 선호하기 때문에 사용하지 않습니다.

• Keyboard

  • Keyboard Shortcuts... > Modifier Keys.. > Caps Lock; Emacs를 사용하신다면 Control로 변경하는게 훨씬 편합니다.
  • Text Input > Edit를 선택해서 Show Input menu in menu bar를 제외하고 모든 옵션의 선택을 해제합니다. 그리고 Text Replacements...에 등록된 모든 것들을 제거합니다.
  • Text > Replace 항목 모두 삭제하고 왼쪽에 있는 모든 선택 항목을 해제; 개발관련 업무를 진행중이시면 Use smart quotes and dashes를 해제하시면 사소한 실수를 줄일 수 있으며, 자동 변경과 관련된 모든 옵션은 사용하지 않습니다.

한/영 변환키를 Shift+Space로 변경하는 방법

• @adhrinae님이 트윗으로 좋은 방법 알려주셔서 해당 항목을 수정합니다. 아래 방법을 사용해보세요!

plist 변경하지 않고 변경할 키 입력하는 창에서 Fn+Shift+Space를 누르면 Shift+Space로 인식됩니다. 작년즈음부터 이런 방식으로 Shift+Space 한영전환 설정중입니다

• (2022.10.25) Ventura 경우 Fn+Shift+Space가 적용되지 않는 듯 합니다. 그래서 아래 Xcode를 설치하시고 파일을 직접 수정하시면 됩니다. 그리고 Fn키가 없는 키보드를 사용중인 iMac 사용자의 경우 아래 방법으로 Shift+Space 한영전환이 가능합니다.
  • plist를 수정하기 위해서 가장 좋은 방법은 Xcode를 설치하는 것 입니다(여타의 다른 소프트웨어를 사용하셔도 됩니다만 개인적으로 Xcode를 권장합니다).
  • Finder에서 Go > Go to Folder(Command + Shift + G)를 선택하여 ~/Library/Preferences/com.apple.symbolichotkeys.plist를 선택합니다.
  • 해당 파일의 내용 중에서 <key>61</key>을 찾아서 <number>131072</number>로 변경하고 파일을 저장합니다.
  • 저장 후에 맥을 재시동하세요.

Finder(파인더) 설정

• 파인더(Finder)를 실행하고, Finder > Preferences를 실행합니다.
  • General > New Finder windows show
    • 자신의 홈 폴더를 선택합니다.
  • Sidebar 에서 필요하거나 불필요한 폴더를 선택해서 Finder 왼쪽의 즐겨찾기 목록을 수정하세요.
  • Advanced > Show all filename extensions를 선택하세요. 확장자를 확인해야 될 일이 많으시면 해당 옵션을 선택합니다.
  • 특정 폴더의 정렬을 변경하고 싶다면 View > Show View Options을 선택하여, Arrange By와 Sort By를 설정하면 됩니다.

App Store 프로그램 설치

• App Sotre에서 Xcode를 설치하세요.
  • Xcode의 경우 설치시간이 대략 2시간 정도가 소요됩니다. 다운로드 및 설치 시간이 굉장히 길기 때문에 느긋하게 설치하세요. 업무 중에 업데이트 진행하시면 2~3시간 소비되니 설치 및 업데이트에 주의하세요.
• Page, Numbers, Keynote, KakaoTalk, Naver Vibe, Movist 등은 App Store를 사용해서 설치하시면 됩니다.

brew 및 터미널 설정

brew 설치

• 터미널에서 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"를 실행하여, brew를 설치합니다.
  • 자세한 사항은 Brew 공식 홈페이지를 참고하세요.

brew를 사용한 프로그램 설치

• brew 설치 후 자주 사용하는 프로그램을 설치하도록 합니다. 아래 예시는 제가 자주 사용하는 프로그램입니다. 필요한 프로그램이 있으면 search를 사용해서 검색하셔서 설치하시면 됩니다.
  • docker 처럼 Formulae와 Casks에 동일한 이름의 패키지가 존재하고, Casks를 기반으로 설치해야 할 경우 brew install docker --cask로 설치하시면 됩니다.

$ brew install dropbox iterm2 google-chrome visual-studio-code keepingyouawake jetbrains-toolbox gitkraken stats

$ brew search docker
==> Formulae
docker                                   docker-machine-driver-vmware
docker-clean                             docker-machine-driver-vultr
docker-completion                        docker-machine-driver-xhyve
docker-compose                           docker-machine-nfs
docker-compose-completion                docker-machine-parallels
docker-credential-helper                 docker-slim
docker-credential-helper-ecr             docker-squash
docker-gen                               docker-swarm
docker-ls                                docker2aci
docker-machine                           dockerize
docker-machine-completion                lazydocker
docker-machine-driver-hyperkit           mockery
==> Casks
docker                                   homebrew/cask-versions/docker-edge
docker-toolbox

$ brew install docker --cask
Updating Homebrew...
==> Auto-updated Homebrew!
Updated 2 taps (homebrew/core and homebrew/cask).
==> Updated Formulae
Updated 20 formulae.
==> Updated Casks
Updated 1 cask.

==> Downloading https://desktop.docker.com/mac/main/amd64/69879/Docker.dmg
######################################################################## 100.0%
==> Installing Cask docker
==> Moving App 'Docker.app' to '/Applications/Docker.app'
==> Linking Binary 'docker-compose.bash-completion' to '/usr/local/etc/bash_comp
==> Linking Binary 'docker.zsh-completion' to '/usr/local/share/zsh/site-functio
==> Linking Binary 'docker.fish-completion' to '/usr/local/share/fish/vendor_com
==> Linking Binary 'docker-compose.fish-completion' to '/usr/local/share/fish/ve
==> Linking Binary 'docker-compose.zsh-completion' to '/usr/local/share/zsh/site
==> Linking Binary 'docker.bash-completion' to '/usr/local/etc/bash_completion.d
🍺  docker was successfully installed!

폰트 설치

• brew install homebrew/cask-fonts/font-d2coding
• brew install homebrew/cask-fonts/font-ibm-plex

iterm2 설정

• iterm2의 컬러 테마는 이 곳에서 다운로드하여 설치합니다.
  • Preferences > Profiles > Colors > Color Presets > Import... 를 선택해서 다운로드 받은 컬러 테마의 압축 폴더 중에서 schemes에 있는 설정 파일을 선택하시면 됩니다.
• iterm2 > Preferences에서 몇가지 환경설정을 합니다.
  • Appearance > Theme : Dark 혹은 원하시는 Theme를 선택합니다.
  • Appearance > Windows > Hide scrollbars : 사용함으로 선택합니다.
  • Appearance > Windows > Show line under title bar when the tab bar is not visible : 사용하지 않습니다.
  • Appearance > Panes > Side margins와 Top & bottom margins을 15 정도로 설정합니다.
  • Profiles > Text > Font: D2Coding을 선택하세요. ZSH의 테마를 설정하시면 Powerline 폰트가 필요할 경우가 있는데, D2Coding을 선택하시면 큰 문제 없이 사용할 수 있습니다.
  • Profiles > Session > Status bar enabled: CPU나 RAM 등의 정보를 터미널에 표시하는 것으로 필요한 것을 추가해서 사용하세요.
    

Zsh 설정

• oh-my-zsh을 설치(sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)") 합니다.
• zsh 플러그인을 설치합니다.
  • brew install zsh-completions fasd를 설치합니다.
  • git clone https://github.com/zsh-users/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting
  • git clone https://github.com/zsh-users/zsh-autosuggestions $ZSH_CUSTOM/plugins/zsh-autosuggestions
  • 설치된 플러그인을 ZSH에서 활성화 하기 위해서 ~/.zshrc 파일의 plugins 항목에 git, zsh-syntax-highlighting, zsh-autosuggestions, fasd 를 설치합니다. 항목을 작성하실 때 plugins=(git zsh-syntax-highlighting zsh-autosuggestions fasd)와 같이 ,가 아닌 공백으로 구분하시면 됩니다.
• theme는 이 곳을 참고하세요.
  • 저는 개인적으로 agnoster를 사용합니다. Spaceship ZSH등과 같은 테마도 있으니 검색해서 자신만의 테마를 선택해보세요.
    

필요한 개발 환경 설정

(애증의) Ruby

• Ruby의 경우 사용하시는 버전이 각자 다르기 때문에 버전 관리자를 먼저 설치하도록 하겠습니다.

$ brew install rbenv

• .zshrc에 eval "$(rbenv init - zsh)"를 입력해주세요.

// Ruby
$ rbenv install 3.1.2
$ rbenv rehash
$ rbenv global 3.1.2
$ ruby -v
ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-darwin21]

Haskell

• 즐거운 프로그래밍 언어인 Haskell도 brew를 사용해서 손쉽게 설치 가능합니다. :D

$ brew install ghcup
$ ghcup install stack 2.9.1
$ ghcup set stack 2.9.1
$ stack ghci

모두 즐거운 개발 되세요!

Updated

• 2022.10.25
  • Ventura로 문서 업데이트
  • 이미지 수정 및 M1/M2 사용자를 위한 간단한 가이드 추가
• 2021.10.25
  • Monterey로 문서 업데이트
  • 이미지가 없어서 불편하다는 의견을 반영해서, 도움이 될만한 이미지 추가
• 2021.01.12
  • brew를 사용해서 pyenv(>=1.2.22) 설치
  • brew를 사용해서 nvm(>=0.37.2) 설치
• 2021.01.02
  • pyenv 설치 변경
  • 오타 수정
• 2020.11.14
  • Big Sur 변경
  • pyenv 설치 에러 관련해서 설치방법