Unity で高性能かつ動作が軽快な Visual Studio Code（VS Code） を使い始める for Windows & Mac

# はじめに
**Visual Studio Code はいいぞ。**

ということでUnityでVS Codeを使い始めるための記事をまとめます。
Unity 2017.3 で動作確認しました。

# UnityでVS Codeを使い始める

## Visual Studio Code を無料でダウンロード
[ここ:link:](https://code.visualstudio.com/download) からお使いのPCに合った Visual Studio Code をダウンロードします。
ダウンロードに関してもし分からなければ Windows であれば [ここ:link:](https://eng-entrance.com/texteditor-vscode) を参考にすると良いです。
Mac はダウンロードされた zip ファイルを解凍（ダブルクリック）するだけです。

## Unityの設定(Mac)

（Yosemiteで確認）

1. Unityを開いた状態で，画面上部のメニューバーから **`Unity`→`Preferences...`** を選択（もしくは ⌘+, ）
    * するとUnity Preferencesが開きます。

2. 左側の上から2番目の **External Tools** をクリック
    * デフォルトの状態であれば一番上のExternal Script Editorのプルダウンメニューが`internal`になっています。
3. そこの **`internal`** をクリックして，一番下の **`Browse...`** をクリック
    * Browse for application が開かれます。
4. **アプリケーション**フォルダ（VSCodeがインストールされているフォルダ）に移動
    * 保存先がデフォルトであれば`アプリケーションフォルダ`にインストールされています。
5. **Visual Studio Code** をクリックして選択
    * 右下の Open が青くなって押せるようになる
6. **Open** をクリック
    * External Script Editor が `Code` になっていることが確認できます。
7. Unity Preferences を**閉じる**
8. 画面上部のメニューバーから **`Assets` → `Open C# Project`** をクリック
    * VS Codeが起動し，「リリースノート」か「ようこそ」のタブが開かれると思います。

※ 8\. の画面上部のメニューバーから **`Assets` → `Open C# Project`** をクリックする処理は Unity で**プロジェクトを新しく作るたびに一度だけ必要**になります

## VS Codeの設定(Mac)
9. **ようこそ** のタブをクリックして移動し，開始 の下にある **フォルダーを開く...** をクリック 

10. 開きたい**プロジェクトのフォルダを選択** して **開く** をクリック
    * たとえば `UnityTestProject` という名前でプロジェクトを作成していたら，`UnityTestProject` のフォルダを探してクリックして選択し，開く をクリックします。
11. ダイアログで「ワークスペースの構成をファイルとして保存しますか？」と聞かれたら **保存しない** を選択
12. Unityに戻ってCreateからスクリプトを作りダブルクリックして **スクリプトを開く**
    * ちゃんとVSCodeで開かれると思います。
13. 右下に「:information_source:このファイルの種類には拡張機能 `C#` が推奨されます。」などと表示されたら **インストール** をクリック
    * C#の拡張機能がインストールされます
14. 左側に表示される「**再読み込み**」というボタンをクリック
    * エディタが再読み込みされて，`OmniSharp for OSX` と `.NET Core Debugger (macOS / x64)` などがダウンロード&インストールされます。
    * 少しの間待ちます。
    * 完了すると一番下のバーに炎のマークとRunningが表示されます。
15. The .NET CLI tools cannot be located. .NET Core debugging will not be enabled. Make sure .NET CLI tools are installed and are on the path. などと言われたら，**Disable this message in user settings** をクリック
    * 勝手にユーザー設定が開いて設定されます。
16. **ユーザー設定タブの ×** を押して（もしくは ⌘ + W で）タブを閉じる
17. 他にも右下にエラーが出ていたら表示内容に従うか，×を押すなどして閉じる
18. **とりあえず設定はおしまい！**

## Unityの設定(Windows)
(Windows10 で確認)

おおよそMacと同様です。

1. Unityを開いた状態で，画面上部のメニューバーから **`Edit`→`Preferences...`** を選択
    * するとUnity Preferencesが開きます。

2. 左側の上から2番目の **External Tools** をクリック
    * デフォルトの状態であれば一番上のExternal Script Editorのプルダウンメニューが`internal`になっています。

3. そこの **`internal`** をクリックして，一番下の **`Browse...`** をクリック
    * Browse for application が開かれます。

4. **`C:\Program Files\Microsoft VS Code`**（VSCodeがインストールされているフォルダ）に移動
    * 保存先がデフォルトであれば `C:\Program Files\Microsoft VS Code` にインストールされています。
    * 上のアドレスをコピーして上部のアドレスバーにペーストすると楽です。

5. **Code.exe** もしくは Code をクリックして選択

6. 右下の **開く** をクリック
    * External Script Editor が `Code` になっていることが確認できます。

7. Unity Preferences を**閉じる**

8. 画面上部のメニューバーから **`Assets` → `Open C# Project`** をクリック
    * VS Codeが起動し，リリースノート か ようこそ のタブが開かれると思います。

※ 8\. の画面上部のメニューバーから **`Assets` → `Open C# Project`** をクリックする処理は Unity で**プロジェクトを新しく作るたびに一度だけ必要**になります。

## VS Codeの設定(Windows)
9. **ようこそ** のタブをクリックして移動し，開始 の下にある **フォルダーを開く...** をクリック 

10. 開きたい**プロジェクトのフォルダを選択** して **開く** をクリック
    * たとえば `UnityTestProject` という名前でプロジェクトを作成していたら，`UnityTestProject` のフォルダを探してクリックして選択し，開く をクリックします。

11. ダイアログで「ワークスペースの構成をファイルとして保存しますか？」と聞かれたら **保存しない** を選択

12. 一旦 Unity に戻って Create からスクリプトを作りダブルクリックして **スクリプトを開く**
    * ちゃんとVSCodeで開かれると思います。

13. 右下に「:information_source:このファイルの種類には拡張機能 `C#` が推奨されます。」などと表示されたら **インストール** をクリック
    * C#の拡張機能がインストールされます

14. 左側に表示される「**再読み込み**」というボタンをクリック
    * エディタが再読み込みされて，`OmniSharp` や `.NET Core Debugger` などがダウンロード&インストールされます。
    * 少しの間待ちます。
    * 完了すると一番下のバーに炎のマークと `UnityTestProject.sln` などとプロジェクト名が表示されます。

15. The .NET CLI tools cannot be located. .NET Core debugging will not be enabled. Make sure .NET CLI tools are installed and are on the path. などと言われたら，**Disable this message in user settings** をクリック
    * 勝手にユーザー設定が開いて設定されます。

16. **ユーザー設定タブの ×** を押して（もしくは Ctrl + W で）タブを閉じる

17. 他にも右下にエラーが出ていたら表示内容に従うか，×を押すなどして閉じる

18. **とりあえず設定はおしまい！**


## 素晴らしきVSCodeライフへ
VSCodeの素晴らしさ，良い点を書き始めたら止まらないので割愛させていただきます。
`vscode 使い方` などで検索すれば大量の情報が手に入るので是非どんどん調べて下さい。
便利な機能がたくさんあるので，徐々に使いこなしていきましょう！

とりあえずショートカットをちらっと見ておくことだけおすすめしておきます。
Windows : **Alt + H K** （Altキーを押しながらHキーを押した後，両方離してからKキーを押す）
もしくはここ :point_right: [Visual Studio Code Shortcuts for Windows :link:](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf)
Mac : **ヘルプ → キーボードショートカットの参照**
もしくはここ :point_right: [Visual Studio Code Shortcuts for MacOS :link:](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macOS.pdf)