VS CodeでRを実行
Rコードを書きたいけど、RStudioが重く感じる、またはVS Codeの柔軟性を好むという方へ。VS Codeはスイスアーミーナイフのように、R、Python、その他多くの言語を1つの軽量エディターで扱えます。このチュートリアルでは、VS CodeでRをセットアップし、コード補完、対話型プロット、Shinyアプリまで実行する方法を紹介します。
主要な概念
- languageserver - VS Codeでコード補完、構文チェック、ホバードキュメントを可能にするRパッケージ
- R拡張機能 - エディターをRに接続し、シンタックスハイライト、コード実行、デバッグを提供するVS Code拡張機能
- Shiny拡張機能 - 自動リロード付きで対話型Shiny Webアプリを作成・実行するためのVS Code拡張機能
必要なもの
- VS Codeの基本を完了
- Rとパッケージをダウンロードするためのインターネット接続
- 10〜15分
ステップ1:Rをインストールまたは更新
最高の互換性のためにRバージョン4.0以上が必要です。
- Windows:
- CRAN Windowsから最新のRをダウンロードしてインストーラーを実行
- インストール中、インストールパスをメモ(例:
C:\Program Files\R\R-4.5.3) - 古いバージョンがある場合は、設定 > アプリから先にアンインストール
- macOS:
- CRAN macOSからダウンロードして.pkgインストーラーを実行
- Intel(
/Library/Frameworks/R.framework/Resources/bin/R)かHomebrewのApple Silicon(/opt/homebrew/bin/R)かに注意 - 更新する場合、新しいバージョンが古いものを置き換えます
- Linux:
- パッケージマネージャーを使用(例:Ubuntuで
sudo apt install r-base) - またはCRAN Linuxの手順に従う
- パッケージマネージャーを使用(例:Ubuntuで
ステップ3でVS CodeがRを見つけるように設定するので、ターミナルでR --versionがまだ動作しなくても心配しないでください。
ステップ2:VS CodeにR拡張機能をインストール
- VS Codeを開く
- 左サイドバーの拡張機能アイコンをクリック
REditorSupport.rを検索してREditorSupportのR拡張機能でインストールをクリックPosit.shinyを検索してPositのShiny拡張機能でインストールをクリック
ステップ3:Rインストールパスを見つける
VS Codeを設定する前に、システム上のRがどこにインストールされているか知る必要があります。
Windowsユーザー向け
- エクスプローラーを開く
C:\Program Files\R\に移動R-4.5.3のようなフォルダが表示されます(バージョン番号は異なる場合があります)- そのフォルダを開く →
binフォルダを開く - そこに
R.exeがあります - フルパスは:
C:\Program Files\R\R-4.5.3\bin\R.exe
バージョン番号を書き留めるか覚えておいてください(例:R-4.5.3)- ステップ4で必要になります。
macOSユーザー向け
Rインストールは通常以下の場所のいずれかにあります:
- 標準インストール(IntelまたはApple Silicon):
/Library/Frameworks/R.framework/Resources/bin/R - Apple SiliconのHomebrew:
/opt/homebrew/bin/R - IntelのHomebrew:
/usr/local/bin/R
どのパスがあるか確認するには、ターミナルを開いて入力:
which R
これでRインストールへの正確なパスが表示されます。
Linuxユーザー向け
Rは通常以下にインストールされています:/usr/bin/R
ターミナルを開いて入力して確認:
which R
ステップ4:VS CodeがRを見つけるように設定
- VS Codeで、左下隅の歯車アイコンをクリック
- メニューから設定を選択
- 上部の検索バーに
r.rpath.windows(Windows)、r.rpath.mac(macOS)、またはr.rpath.linux(Linux)と入力 - 設定が表示されるはずです。設定の下のEdit in settings.jsonをクリック
- settings.jsonファイルが開きます
- 中括弧
{}内にプラットフォームに適した設定を追加
Windowsの場合、この行を追加(R-4.5.3をステップ3のバージョンに置き換え):
"r.rpath.windows": "C:\\Program Files\\R\\R-4.5.3\\bin\\R.exe",
なぜバックスラッシュが2つ(\\)なのか? JSONファイルでは、バックスラッシュ\は特殊文字(エスケープ文字と呼ばれる)です。実際のファイルパスで1つのバックスラッシュを表すには、\\と2つ入力する必要があります。そのためC:\Program Filesはsettings.jsonではC:\\Program Filesになります。
macOSの場合、これらの行のいずれかを追加:
"r.rpath.mac": "/Library/Frameworks/R.framework/Resources/bin/R",
または、Apple SiliconでHomebrewでRをインストールした場合:
"r.rpath.mac": "/opt/homebrew/bin/R",
Linuxの場合、追加:
"r.rpath.linux": "/usr/bin/R",
- ファイル > 保存をクリックしてファイルを保存
- 変更を有効にするにはVS Codeを完全に再起動
ステップ5:必要なRパッケージをインストール
- VS Codeで、トップメニューの表示をクリックし、コマンドパレットを選択
R: Create R Terminalと入力して選択- 下部のターミナルパネルにRコンソールが表示されます
- バージョン情報とともにRが起動するのが見えるはずです
- エラーが表示された場合は、ステップ4のsettings.json設定を再確認してVS Codeを再起動してください
- これらのコマンドを1つずつ入力してパッケージをインストール:
install.packages("languageserver")
install.packages("shiny")
- インストールが完了するまで待つ(数分かかる場合があります)
q()と入力してEnterを押してRを終了- ワークスペースを保存するか聞かれたら
nと入力
通常のターミナルで単にRと入力してもRがシステムPATHにない限り動作しません。R拡張機能はr.rpath設定を使用してRを見つけます。
ステップ6:Rプロジェクトを作成
- コンピュータに新しいフォルダを作成(例:
my-r-project) - VS Codeでファイル > フォルダーを開くをクリックして新しいフォルダを選択
- トップメニューでファイル > 新規ファイルをクリック
- ファイル > 保存をクリックして
analysis.Rとして保存
ステップ7:最初のRスクリプトを書く
analysis.Rに以下のコードを入力:
# irisデータセットを読み込み
data(iris)
# 最初の数行を表示
head(iris)
# 要約統計を生成
summary(iris)
hist(iris$Sepal.Length)
- ファイル > 保存をクリックしてファイルを保存
ステップ8:Rコードを対話的に実行
analysis.Rを開いた状態で、コードの行を選択してCtrl+Enter(Windows/Linux)またはCmd+Enter(Mac)を押して実行- ターミナルが開いていない場合、最初の
Ctrl+Enter/Cmd+EnterでRターミナルが開き、2回目でコードが実行されます - ターミナルに出力が表示され、プロットは別ウィンドウで開きます
- すべての行を選択して同じ方法で実行することもできます
ステップ9:シンプルなShinyアプリを作成
- プロジェクトフォルダに新しいファイルを作成:ファイル > 新規ファイル
app.Rとして保存- 以下のコードを入力:
library(shiny)
ui <- fluidPage(
titlePanel("Interactive Histogram"),
sidebarLayout(
sidebarPanel(
sliderInput("bins",
"Number of bins:",
min = 5,
max = 50,
value = 30)
),
mainPanel(
plotOutput("histogram")
)
)
)
server <- function(input, output) {
output$histogram <- renderPlot({
x <- faithful$waiting
bins <- seq(min(x), max(x), length.out = input$bins + 1)
hist(x, breaks = bins, col = "steelblue", border = "white",
xlab = "Waiting time (minutes)",
main = "Distribution of Waiting Times")
})
}
shinyApp(ui = ui, server = server)
- ファイルを保存
- エディター右上に表示される▶ボタンに注目
- ドロップダウンをクリックしてRun Shiny Appを選択
- アプリがブラウザまたはVS Codeパネルで開きます
- スライダーを動かすとヒストグラムが即座に更新されます
ステップ10:コード補完とホバーヘルプを使用
analysis.Rで、新しい行にmeaと入力し始める- 提案を含むドロップダウンが表示されます - Enterを押して
mean()を選択 - 既存コードの
meanという単語の上にマウスを置く - 関数のドキュメントと使用例を表示するポップアップが現れます
lm、summary、またはplotの上にマウスを置いてドキュメントを確認data$と入力するとVS Codeが列名(xとy)を提案します
ステップ11:他の機能を試す
- Markdown統合:コード、出力、テキストを混在させるR Markdownファイル(
.Rmd)を作成 - コードフォーマット:Rスクリプト内で右クリックしてFormat Documentを選択してコードを自動フォーマット
- デバッグ:行番号の左をクリックしてブレークポイントを設定し、デバッグモードでコードを実行
- Git統合:VS Codeの内蔵Git機能を使用してRプロジェクトをバージョン管理
次のステップ
- 別々の
ui.Rとserver.RファイルでマルチファイルShinyアプリを作成 - 高度なデータ可視化のためにggplot2を探索
- データ操作のためにtidyverseパッケージ(
dplyr、tidyr)を試す - 埋め込みRコードでレポートを作成するためにR MarkdownやQuartoを学ぶ
- 高度なデバッグのためにR Debugger拡張機能をインストール
トラブルシューティング
- VS Codeターミナルで「R is not recognized」:VS CodeがRを見つけられません。settings.json(ステップ4)を確認 - Rパスが正しく
R.exe(Windows)またはRバイナリ(Mac/Linux)を指していることを確認。パスの例:- Windows:
C:\\Program Files\\R\\R-4.5.3\\bin\\R.exe(バージョン番号を調整) - macOS Intel:
/Library/Frameworks/R.framework/Resources/bin/R - macOS Homebrew:
/opt/homebrew/bin/R - Linux:
/usr/bin/R修正後、VS Codeを完全に再起動してください。
- Windows:
-
設定のRバージョン不一致:Rを更新したがVS Codeがまだ古いバージョンを使用している場合、settings.jsonの
r.rpath設定のバージョン番号を新しいRインストールに合わせて更新してください(ステップ3で現在のインストールパスを見つける)。 -
コード補完が動作しない:languageserverが正常にインストールされたことを確認(ステップ5)。インストール後にVS Codeを再起動。Rファイルを開いた後、言語サーバーが初期化されるまで10〜20秒待つ。出力パネル(表示 > 出力 > R Language Server)でエラーを確認。
-
プロットが表示されない:プロットはRのデフォルトグラフィックスデバイスを使用して別ウィンドウで開きます。ウィンドウマネージャーが利用可能であることを確認。一部のシステムでは、X11(macOS)をインストールするか、グラフィックスサポートが有効であることを確認する必要があるかもしれません。
- Shinyアプリが実行されない:Shiny拡張機能がインストールされていることを確認(ステップ2)、shinyパッケージがインストールされていること(ステップ5)、ファイル名が
app.Rであること。ターミナルでエラーメッセージを確認。実行ボタンはVS CodeがファイルをShinyアプリとして認識したときのみ表示されます。
ワークフロー概要
VS CodeはRStudioに代わるモダンで軽量な環境を提供し、以下の主な利点があります:
- 統一環境:1つのエディターでR、Python、JavaScriptなどをコーディング
- カスタマイズ可能:軽量なセットアップのために必要な拡張機能のみインストール
- 統合ターミナル:R、Git、シェルコマンドを並行して実行
- Shiny開発:自動リロードでワンクリックアプリ起動が時間を節約
- バージョン管理:外部ツールなしでGit統合
Steven Geが2025年12月7日に作成。