【Mac】UnityでのVSCodeの導入手順とおすすめ設定、拡張機能

# はじめに
Unityを使う際、デフォルトではスクリプトエディタとしてVisual Studioが設定されていますが、「VSCode便利だよ」と先輩エンジニアの方に勧めて頂いたので導入してみました。結果、色々カスタマイズできて便利だったので、備忘録として導入手順とおすすめ設定をまとめてみました。

# VSCodeのインストール
下のリンクからダウンロードし、インストールする。
[Download Visual Studio Code](https://code.visualstudio.com/download)

# Unityの設定
### デフォルトのスクリプトエディタをVSCodeに変更する
[Unity] → [Preferences] → [External Tools] → [External Script Editor] → [Browse]
finderが開くので「Visual Studio Code.app」を探してきて選択する。

[External Script Editor]に「Code」と表示されていればOK。
![スクリーンショット 2019-05-02 3.27.56.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/336656/4796ad13-fe9b-a1f5-4edd-55b5a84ccbb8.png)


# VSCodeのおすすめ設定と拡張機能
## 設定
### 自動保存

[File] → [Auto Save]にチェックをつける。

### 自動整形
[Code] → [Prefarences] → [Settings]
で設定画面を開く
下記３つの項目にチェックをつける。

・Format On Paste
→ペースト時に自動でフォーマット
・Format On Save
→ファイル保存時に自動でフォーマット(自動保存では整形してくれないので、手動で「cmd+S」する必要あり)
・Format On Type
→入力した行を自動でフォーマット

また、後述の拡張機能「C#」をインストールする。
**これを入れて置かないと自動整形が働かないので注意。**

### ミニマップを非表示
横に出てくるやつです。個人的にいらなかったので非表示にしました。

[Code] → [Prefarences] → [Settings]
で設定画面を開く。
以下の項目のチェックを外す
・Editor › Minimap: Enabled

![](https://image.itmedia.co.jp/ait/articles/1811/02/dt-01.gif)
[VS Codeのミニマップの表示／非表示を切り替えるには](https://www.atmarkit.co.jp/ait/articles/1811/02/news014.html)

### .metaファイルを非表示
デフォルトだと.metaファイルが表示されて邪魔なので非表示にします。

[Code] → [Prefarences] → [Settings]
で設定画面を開く。

・Files:Exclude

の項目に以下を追加してOKを押す。

`**/*.meta`

![スクリーンショット 2019-05-04 21.34.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/336656/608aed56-501f-fec8-af69-d0a2a808027d.png)



## 拡張機能

### [C#](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp)
必須。C#が使えるようになる。

### [Japanese Language Pack for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-ja)
VSCodeの日本語化。

### [vscode-icons](https://marketplace.visualstudio.com/items?itemName=vscode-icons-team.vscode-icons)
ファイルとかフォルダにアイコンがついて見やすくなる。
![](https://raw.githubusercontent.com/vscode-icons/vscode-icons/master/images/screenshot.gif)

### [Bracket Pair Colorizer](https://marketplace.visualstudio.com/items?itemName=CoenraadS.bracket-pair-colorizer)
メソッドとかの{}を階層毎に色分けしてくれる。
![](https://github.com/CoenraadS/BracketPair/raw/master/images/example.png)

### [zenkaku](https://marketplace.visualstudio.com/items?itemName=mosapride.zenkaku)
コードに混ざった全角をわかりやすくしてくれる。
![](https://github.com/mosapride/vscode-zenkaku/blob/images/readme01.png?raw=true)

### [Debugger for Unity](https://marketplace.visualstudio.com/items?itemName=Unity.unity-debug)
デバッガー機能が使えるようになる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/336656/1b287a96-d7bb-4701-9e75-5f54ad06bee5.png)

### [C# XML Documentation Comments](https://marketplace.visualstudio.com/items?itemName=k--kato.docomment)
sammaryを一瞬で表示できるようになる。
![](https://github.com/kasecato/vscode-docomment/raw/master/images/docomment.gif)

### [MonoBehaviour Snippets](https://marketplace.visualstudio.com/items?itemName=zrachod.mono-snippets)
Startメソッドとかを一瞬で書けるようになる。
![](https://i.imgur.com/LVoUl5X.gif)

### [C# Extensions](https://marketplace.visualstudio.com/items?itemName=jchannon.csharpextensions)
C#のクラスを作れたりとか色々できる。
![](https://github.com/jchannon/csharpextensions/raw/master/featureimages/newclass.gif)

### [Rainbow CSV](https://marketplace.visualstudio.com/items?itemName=mechatroner.rainbow-csv)
csvを列ごとに色分けしてくれる。
![](https://i.imgur.com/PRFKVIN.png)

### [Edit csv](https://marketplace.visualstudio.com/items?itemName=janisdd.vscode-edit-csv)
vscode上でcsvを表形式で編集できる。Excelで編集すると意図しない補正がかかったり、文字化けしたりと勝手が悪いのでこちらを使うことをおすすめ。
![](https://github.com/janisdd/vscode-edit-csv/raw/master/images/titleImg.gif)

###[Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker)
スペルミスを指摘してくれる。スペルミスによって取り返しのつかない状況になったことがあるので、必ず入れましょう。

![](https://raw.githubusercontent.com/streetsidesoftware/vscode-spell-checker/master/packages/client/images/example.gif)

###[Quit Control for VSCode](https://marketplace.visualstudio.com/items?itemName=artdiniz.quitcontrol-vscode)

command+wを連打してもウインドウごと閉じなくなる
![](https://github.com/artdiniz/quit-control-vscode/raw/master/images/closeTab.gif)

# Git関連
###.gitignoreに追記
VSCodeを起動すると、プロジェクト内に「.vscode」という名前の隠しフォルダが作成されます。この中にはVSCodeの設定ファイルが入っています。
Gitを使って複数人でプロジェクト管理をしている場合は、これをプッシュしてしまうと良くないので.gitignoreに以下を追記します。

```tex
.vscode/*
```

###settings.jsonの書き換え
競合が起きた際に編集できるようにするため、拡張子が「.unity」と「.prefab」のファイルを非表示から表示に変更します。settings.jsonを開き、以下のようにfalseに変更してください。

```tex
"**/*.prefab": false,
"**/*.unity": false,
```

# 最後に

個人で色々アプリを出してるので、ぜひインストールおなしゃす！！！m(_ _)m
・[iOS](https://apps.apple.com/jp/developer/tomonari-ieko/id1493275230?l=en)
・[android](https://play.google.com/store/apps/developer?id=tomonari+ieko)


# 参考
[今日からUnity + Visual Studio Codeを用いた快適な開発生活(随時更新中)
](https://qiita.com/4_mio_11/items/e7b0a5e65c89ac9d6d7f) [VSCodeのオススメ拡張機能 24 選 (とTipsをいくつか)](https://qiita.com/sensuikan1973/items/74cf5383c02dbcd82234)
[VS CodeでUnityプログラミングしてる僕が入れてる拡張機能](https://qiita.com/OrotiYamatano/items/4e2c8fc33416df7ec3c3)