コードの補完を使いこなす(Tab・Esc・次の候補)

GitHub Copilot は、コードを入力している途中で、続きを提案します。この記事では、VS Code で提案を受け入れる・消す・別の候補に切り替えるキーと、提案が出ないときの確かめ方を説明します。画面は、公式ドキュメントの画面と編集部の図で説明します。

コードの補完とは

VS Code の Copilot の補完は、公式には「インライン提案(inline suggestions)」と呼ばれます。種類は 2 つです。

• ゴーストテキスト: カーソルの位置に、続きのコードが薄い文字で表示されます。
• 次の編集の提案(Next edit suggestions、略して NES): いまの編集をもとに、次に直す場所と内容を予測します。ガター(行番号の横の部分)に表示される矢印で知らせます。

コードの補完と次の編集の提案は、AI クレジットを使いません。有料プランでは回数の上限がなく、Free では補完が月 2,000 回までです。

提案を受け入れる・消す・切り替える

提案が出たら、Tab で受け入れ、Esc で消します。提案にマウスを重ねると、ツールバーが表示されます。「< 1/3 >」で候補を切り替えたり、Accept Word で単語ごとに受け入れたりできます。

キーの一覧

Mac のキーの記号は、⌘ が Command、⌥ が Option です。

キーは、GitHub Docs「Keyboard shortcuts for GitHub Copilot in the IDE」と VS Code のドキュメントにある既定のキーです。

次の編集の提案(NES)を使う

ガターの矢印にマウスを重ねると、メニュー(Go To / Accept、Reject、Show Collapsed、Settings)が表示されます。

コメントで、書きたいことを伝える

書きたい処理をコメントで書いておくと、それに沿った提案が出ます。公式のドキュメントには、コメントで頼んで、TypeScript のクラスを提案させる例が載っています。

なお、カスタム指示(Copilot に伝えたいルールを書いておくファイル)は、インライン提案には使われません。

オン・オフと一時停止

ステータスバー(画面のいちばん下の行)の Copilot のアイコンから、メニューを開きます。

• All files: すべてのファイルで、提案をオン・オフします。
• いまの言語(画面では TypeScript): 開いているファイルの言語だけ、オン・オフします。
• Next edit suggestions: 次の編集の提案をオン・オフします。
• Snooze: 提案を 5 分ずつ止めます。Cancel Snooze で再開します。コマンドパレットの「Snooze Inline Suggestions」でも止められます。

編集部の VS Code 1.141.0 では、サインインの前のこのメニューに「Inline Suggestions」と表示されていました。上の公式の画面(「Code Completions」)と、表示の名前が違うことがあります。

Markdown とプレーンテキストでは、最初は提案が出ない

設定 github.copilot.enable の既定の値は次のとおりです。"*" はすべての言語のことで、プレーンテキスト(plaintext)と Markdown(markdown)は、最初からオフになっています。

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": false,
    "scminput": false
  }
}

Markdown を書くときにも提案を使いたい場合は、Markdown のファイルを開いた状態で、ステータスバーの Copilot のメニューから、いまの言語のチェックを入れます。

提案に使うモデルを変える

タイトルバーのチャットのメニューから Configure Inline Suggestions... を選び、Change Completions Model... でモデルを選びます。選べるモデルがないときは、この項目は表示されません。

提案が出ないとき

提案が出ないときは、次の順に確かめます。

• 従量制の接続: VS Code が従量制(使った量で料金がかかる)の接続だと判断したときは、自動の提案を出しません。手動の「Trigger Inline Suggestion」(Alt+\、Mac は ⌥+\)なら出せます。
• 公開コードとの一致のブロック: GitHub の Copilot の設定ページで、公開されているコードに一致する提案を Block にしていると、提案が少なくなることがあります。
• 回数: Free の補完は月 2,000 回までです。補完の枠と AI クレジットの枠は別で、片方を使い切っても、もう片方は使えます。どちらも毎月リセットされます。

次の回では、Copilot Chat で質問したり、コードの一部を直してもらったりする方法を説明します。