普段エディタとして Emacs を使用していますが、vimとのいいとこ取りをした(?) 「spacemacs」なるものがあることを（今さら）知ったので、インストールして使うことにしました。

公式のインストール手順も丁寧に書かれているし、特につまずくところもないのですが、メモとして残しておきます。

インストール

事前に

インストール済みEmacsのアンインストール

ベースとするEmacsとして、公式のインストール手順にも記載されている emacs-plus を使うので、
すでにEmacsがインストールされている場合はアンインストールしておきます。

.emacsの退避

既存のEmacs設定 ~/.emacs.d および ~/.emacs をリネームするなどして退避しておきます。

$ cd ~
$ mv .emacs.d .emacs.d.bak
$ mv .emacs .emacs.bak

emacs-plusのインストール

改めて emacs-plus をインストールします。

$ brew tap d12frosted/emacs-plus
$ brew install emacs-plus --with-spacemacs-icon
$ ln -s /usr/local/opt/emacs-plus/Emacs.app /Applications

spacemacsのインストール

spacemacs をインストールします。
インストールというより、 spacemacs 用に構成された設定ファイル群 .emacs.d をGutHubからクローンして配置するだけですね。

推奨フォントのインストール

公式のインストール手順では任意になっていますが、見やすいフォントなのでインストールしておきます。

$ brew tap caskroom/fonts && brew cask install font-source-code-pro

spacemacsのクローン

GitHub から、spacemacs をクローンして ~/.emacs.d として配置します。

$ cd ~
$ git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d

Emacsの起動

Emacsを起動します。

$ emacs

spacemacs のインターフェースで起動すれば、インストールは成功です。

基本設定

初回起動時に、いくつかの基本設定をどうするか聞いてきます。

キーバインド

What is your preferred editing style?
  Among the stars aboard the Evil flagship (vim)
  On the planet Emacs in the Holy control tower (emacs)

キーバインドをvim風にするか、emacsのままにするかを選択します。
spacemacs の名の通り、vim風にすることで（escではなく） space によるモード切り替えができるようになるのが最大のメリットです。

自分はあくまでEmacsキーバインドを使いたかったので、emacs を選択しました。

ちなみに、ここでは選択肢として出てこないですが、hybrid と言うキーバインドもあります。（spacemacs の設定ファイル ~/.spacemacs で変更できます）
ただ、vimのキーバインドが優先のようで、Emacsキーバインド派には使いにくいなーと思います。

spacemacsの構成

What distribution of spacemacs would you like to start with?
  The standard distribution, recommended (spacemacs)
  A minimalist distribution that you can build on (spacemacs-base)

spacemacs を標準構成にするか、最小構成にするかを選択します。

推奨の spacemacs を選択しました。

補完フレームワークの選択

What type of completion framework do you want?
  A heavy one but full-featured (helm)
  A lighter one but still very powerful (ivy)
  None (not remomended)

編集時の補完に何を使うかを選択します。
この辺、詳しくないですが君は誰とEmacsる？ (補完インターフェイス紹介篇) を参考に、軽量そうな ivy にしました。

カスタマイズ

あとはお好みでカスタマイズしていきます。
spacemacs では、設定は通常の ~/.emacs.d/init.el ではなく ~/.spacemacs に記述していきます。

ターミナル内で起動する

ターミナル上で emacs コマンドで起動すると、ターミナル上ではなく別ウィンドウでアプリとして起動してしまいます。
-nw オプションを指定することでターミナル上で起動できますが、毎回指定するのが面倒なので ~/.bashprofile や ~/.zshrc でエイリアスを切っておきます。

alias emacs='emacs -nw'

レイヤーのインストール

通常のEmacsで追加機能をインストールするには、package-install などを使ってインストールしますが、
spacemacs では「レイヤー」と呼ばれる独自の機能拡張の仕組みを使います。

設定ファイル ~/.spacemacs に、インストールするレイヤーを指定する項目があり、
そこにインストールしたいレイヤーを追記することで起動時に自動的にインストールされます。

~/.spacemacs

   dotspacemacs-configuration-layers
   '(
     ;; ----------------------------------------------------------------
     ;; Example of useful layers you may want to use right away.
     ;; Uncomment some layer names and press <SPC f e R> (Vim style) or
     ;; <M-m f e R> (Emacs style) to install them.
     ;; ----------------------------------------------------------------
     ivy
     ;; auto-completion
     ;; better-defaults
     emacs-lisp
     ;; git
     ;; markdown
     ;; org
     ;; (shell :variables
     ;;        shell-default-height 30
     ;;        shell-default-position 'bottom)
     ;; spell-checking
     ;; syntax-checking
     ;; version-control
     )

この状態では、（起動時に選択した補完フレームワークの）ivy が有効化されています。
レイヤー一覧からインストールしたいレイヤーを探して、ここに追記していけばOKです。

あと、特定のファイル（JSONとかYAMLとか）を開こうとすると、対応するレイヤーをインストールするか聞いてくるので、そこで都度インストールしても良いです。

僕は以下のレイヤーをインストールしました。

レイヤー	説明
ivy	キーワード補完（初回起動時に選択）
better-defaults	Emacsキーバインドの機能強化
osx	macOS向けの機能強化
git	Gitクライアント（magit）を使えるようにする
emacs-lisp	Emacs Lisp の言語サポート（デフォルトで有効になってる）
markdown	マークダウンの言語サポート
html	HTMLの言語サポート
javascript	JavaScriptの言語サポート
yaml	YAMLの言語サポート
java	Javaの言語サポート
scala	Scalaの言語サポート
python	Pythonの言語サポート
sql	SQLの言語サポート

ユーザーの独自設定

ユーザー独自の設定は、~/.spacemacs の user-init() 関数に記述するようです。

僕の場合は以下の設定を追加しました。