Visual Studio Code での R
R プログラミング言語は、統計計算とグラフィックスのために作られた動的言語です。R は統計分析、科学計算、機械学習、データ可視化でよく使用されます。
Visual Studio Code 用の R 拡張機能は、拡張構文ハイライト、コード補完、Lint (静的解析)、フォーマット、R ターミナルとの対話、データ・プロット・ワークスペース変数の表示、ヘルプページの閲覧、パッケージの管理、R Markdown ドキュメントでの作業をサポートします。
はじめに
-
お使いのプラットフォームに R (>= 3.4.0) をインストールします。Windows ユーザーの場合は、R 拡張機能が R の実行ファイルを自動的に見つけられるように、インストール中に [Save version number in registry (バージョン番号をレジストリに保存)] をチェックすることをお勧めします。
-
R に
languageserver
をインストールします。install.packages("languageserver")
-
Visual Studio Code 用 R 拡張機能をインストールします。
-
R ファイルを作成し、コーディングを開始します。
VS Code での R の使用体験を向上させるために、以下のソフトウェアとパッケージが推奨されます。
-
radian: 公式の R ターミナルの多くの制限を修正し、構文ハイライトや自動補完などの多くの機能をサポートするモダンな R コンソールです。
-
httpgd: HTTP と WebSocket を介して非同期で SVG グラフィックスを提供するグラフィックスデバイスを実装する R パッケージです。このパッケージは、VS Code の R 拡張機能のインタラクティブプロットビューアーで必要です。
R パッケージまたは VS Code 用 R 拡張機能のインストールで問題が発生した場合は、インストールの Wiki ページ (Windows | macOS | Linux) で詳細を確認してください。
R コードの実行
R コードの実行とは、単にコードを R ターミナルに送信することです。R コードを実行する前に、コマンド パレットで [R: Create R terminal (R: R ターミナルの作成)] コマンドを使用して R ターミナルを作成できます。
R ターミナルの準備ができたら、実行したいコードを選択するか、コードの先頭または末尾にカーソルを置き、(Ctrl+Enter)
を押すと、コードがアクティブな R ターミナルに送信されます。
R ファイル全体を実行したい場合は、エディターでファイルを開き、Ctrl+Shift+S
を押すと、ファイルがアクティブな R ターミナルで source (読み込み実行) されます。
複数の R ターミナルの実行や自己管理 R ターミナルなどのより高度な使用法については、Interacting with R terminals (R ターミナルとの対話) をお読みください。
コード補完 (IntelliSense)
R 拡張機能は、R 言語サーバーのおかげで、コード補完やその他多くのコード編集機能をサポートしています。補完機能は、スコープ内および現在の R ワークスペースで利用可能な関数や変数を、パッケージからのドキュメントやコメントとして提供されるドキュメントと共に表示します。
Lint (静的解析)
Lint (静的解析) は、コードの警告や潜在的なエラーをチェックする機能です。R コードの Lint は lintr パッケージによって提供されます。設定ファイルを介して、利用可能な linter のリストから選択してカスタマイズできます。
コード補完と Lint に加えて、R 拡張機能はコードフォーマット、定義へ移動、シンボルの名前変更、参照の検索などの他の機能もサポートしています。詳細については、R Language Service をお読みください。
ワークスペース ビューアー
ワークスペース ビューアーは VS Code のサイドバーにあり、使用中のパッケージとアクティブな R セッションのグローバル変数が含まれています。アクティビティ バーの R アイコンを選択すると、ワークスペース ビューアーとヘルプページ ビューアーが表示されます。これは、R ワークスペースの表示、既存の R オブジェクトのプレビュー、ヘルプ トピックの検索、ヘルプページの対話的な閲覧に便利な方法です。
ワークスペース ビューアーの他に、データ ビューアー、プロット ビューアー、ウィジェット ビューアーもあります。詳細については、Interactive viewers (インタラクティブ ビューアー) をお読みください。
デバッグ
R のデバッグ機能は R Debugger 拡張機能によって提供されます。新しい R プロセスを起動するか、実行中のプロセスにアタッチすることで、R コードまたは R プロジェクトのデバッグをサポートします。
ブレークポイントにヒットすると、現在選択されているスタック フレームの変数を表示または変更したり、そのスタック フレームのデバッグ コンソールで式を評価したりできます。
詳細については、プロジェクトの README をお読みください。
次のステップ
この概要は、VS Code 用 R 拡張機能の簡単な紹介です。機能の詳細なリストについては、拡張機能の README をお読みください。
問題、提案、または機能リクエストがある場合は、GitHub リポジトリで気軽に issue をオープンしてください。
VS Code についてさらに詳しく知りたい場合は、以下のトピックを試してください
- 基本的な編集 - VS Code エディターの基本事項を簡単に紹介します。
- 拡張機能をインストールする - マーケットプレイスで利用可能な他の拡張機能について学びます。
- コード ナビゲーション - ソースコード内をすばやく移動します。