2017.07.12

PrettierをEslintと連携してコード自動整形かつVisual Studio Codeでオートフォーマットする

prettier は JavaScript のコードフォーマッター。
そして prettier-eslint-cli を使うと勝手に .eslintrc の設定見つつフォーマットしてくれるので最高に便利だった。

そんなわけで ❤ My Favorite Editor ❤ である Visual Studio Code での快適なコードフォーマット環境を作るためにいろいろ調べたことをメモしました。

やったこと

って感じ。

必要なのは prettier-eslint-cli くらい。
あとは別途 eslint の設定を作っておく必要があるけどそこはまあお好きに。余談だけれど個人的に @mizchi さんの eslint-config-mizchi が良かった。

あとはコマンド叩くだけだけれどこういうのは npm script にしたい性分なのでそっちのタスクにしておく。
なので package.json に以下を記述。

{
  // ...略
  "scripts": {
    "format": "prettier-eslint --write \"src/**/*.js\""
  }
  // 略...
}

jsファイルは ./src 以下にある想定。
あとは npm run format を叩いたら勝手にフォーマットしてくれる。ちなみに --write オプションはファイルを編集してそのまま上書き保存してくれるよってやつ。

これを Marketplace でインストールして有効にしておく。
Prettier - JavaScript formatter

あとは vscode 上で cmd + , すると開かれる settings.json に以下を追記すれば良い。

{
  "editor.formatOnSave": true,
  "prettier.eslintIntegration": true
}

これで cmd + s したときに勝手に .eslintrc 見てフォーマットしてくれる。

これらを使う。

package.json に以下を追記。

{
  // ...略
  "scripts": {
    "precommit": "lint-staged"
  },
  "lint-staged": {
    "*.js": ["prettier-eslint --write", "git add"]
  },
  // 略...
}

これで git commit をしたときに prettier でのフォーマットを挟むことができるのでフォーマットされていないソースが commit されることを防ぐことができる。

コードレビューの負担も減るし、何も考えずにがんがんコード書いても勝手にフォーマットしてくれるので余計な時間も取られないし、良いことづくめだと思います。
特にやらない理由はない気がする。

そんなことより Vim を ❤ My Favorite Editor ❤ にしたくて勉強している最近なのだけれどやっぱり込み入ってくると vscode を開いちゃうので完全に Vim 縛りで開発やったりとかした方が良いかもしれない。そんなことを思った。おわり。