VS Codeで加速する！Google Apps Scriptローカル開発環境構築ガイド（全4回）【第1回】なぜローカル開発なのか？VS CodeでのGAS開発ロードマップとNode.jsの導入

【第1回】なぜローカル開発なのか？VS CodeでのGAS開発ロードマップとNode.jsの導入

当記事の作成にはAIアシスタントを使用しています。
誤った情報が含まれることもありますのでご了承ください。 

日常業務の効率化や自動化において、Google Apps Script（GAS）は極めて強力なツールです。スプレッドシートやGmail、Googleドライブなどの各種サービスと容易に連携でき、特別な環境構築をしなくてもブラウザ上ですぐにコードを書いて実行できる気軽さは、多くの業務改善担当者にとって大きな魅力となっています。

しかし、GASを使って作成するツールやシステムの規模が大きくなるにつれて、「ブラウザ上のエディタではコードが書きづらい」「少し複雑なコードになるとミスが増える」「過去のコードの管理が難しい」といった悩みに直面していないでしょうか。

本連載は、まさにそうした「ブラウザ版GASエディタの枠を超えて、より高度で快適な開発を行いたい」と考えている方へ向けた実践ガイドです。

本連載を通じて構築するのは、世界中のプロエンジニアに愛用されているコードエディタ「Visual Studio Code（VS Code）」を使った、本格的なGASローカル開発環境です。この環境が完成すると、以下のような圧倒的に快適な開発体験が手に入ります。

• VS Code上でGAS独自のメソッドやクラス（SpreadsheetApp や GmailApp など）の自動補完がスムーズに効く
  
  
• ショートカットキーや画面分割を活用し、ストレスなく複数ファイルを編集・管理できる
  
  
• ターミナルからコマンドひとつで、ローカルで書いたコードをGoogleクラウドへ一瞬で同期・反映できる
  
  

単に「ツールを動かす」段階から、「プロフェッショナルと同じ道具でスマートに開発する」ステップへと進むことができます。

本連載では、すでにGoogleアカウントをお持ちで、パソコンにVS Codeをインストールしており、ファイルの開き方や基本的な入力といった入門レベルの操作ができる方を前提として解説を進めます。

プログラミングの専門知識やコマンドラインの難しい操作に不安がある方でもご安心ください。つまづきやすいポイントやエラーへの対処法も丁寧にフォローしながら、ステップ・バイステップで解説していきます。

それでは、GAS開発の生産性を爆発的に引き上げるローカル開発環境への第一歩を踏み出しましょう！

目次

ブラウザ版GASエディタの限界と、VS Codeへ移行するメリット

ブラウザ版GASエディタ（Web UI）の手軽さと直面する「壁」

Google Apps Scriptの最大のアドバンテージは、ブラウザとGoogleアカウントさえあれば今すぐに開発を始められる手軽さにあります。Googleスプレッドシートのメニューから「拡張機能」→「Apps Script」をクリックするだけで開発画面が開き、数行のコードを書くだけで業務自動化が実現できます。この「準備不要」の手軽さは、プログラミング初心者にとって非常に大きな救いとなります。

しかし、作成するスクリプトが複雑化し、コードの行数が数百行から数千行に及んだり、処理を複数のファイルに分割して管理するようになると、ブラウザ版エディタの「壁」にぶつかることになります。

ブラウザ版エディタで開発を続ける中で直面する代表的な問題は以下の通りです。

• コード補完（入力候補）の弱さとタイポの発生：ブラウザ版エディタにも補完機能は備わっていますが、標準のJavaScript構文やGAS固有のオブジェクトに対する補完精度は十分とは言えません。結果としてスペルミス（タイポ）や引数の設定ミスに気づきにくく、実行して初めてエラーになるケースが頻発します。
  
  
• 画面領域の狭さとファイル編集のしづらさ：ブラウザのタブやヘッダーに画面領域が圧迫され、コードを表示する領域が狭くなりがちです。また、複数のファイルを同時に開いて横並びで比較しながら編集するといった作業が難しく、ファイル間の行き来にストレスが溜まります。
  
  
• 公式ドキュメントとの往復による集中力の切れ：「このメソッドの正しい引数の順序はなんだっけ？」「返り値の型は何だっけ？」と調べるたびに、ブラウザの別タブでGoogle公式リファレンスを検索しなければならず、開発のテンポが大きく阻害されます。
  
  
• コード資産のバックアップやバージョン管理の限界：ブラウザ版GASにも簡易的な「変更履歴」機能はありますが、コードを過去の状態と比較したり、特定の時点に安全に戻したりする機能としては不十分です。ローカルにファイルを保存できないため、手動でテキストファイルにコピペしてバックアップを取るといった非効率な作業が発生しがちです。
  
  

業務を効率化するためのツールを作っているはずなのに、開発作業そのものに時間を奪われてしまう――これが、ブラウザ版GASエディタを使い続けた際に多くの人が陥る罠です。

VS CodeでGASを開発する3つの圧倒的メリット

こうしたブラウザ版エディタの限界を突破する決定的な解決策が、「VS Code（Visual Studio Code）によるローカル開発への移行」です。

VS Codeは、Microsoftが開発している無料かつ高機能なコードエディタであり、現在世界中で最も広く使われている開発環境のひとつです。GASの開発環境をVS Code上に構築することで、主に以下の3つの圧倒的なメリットを享受できます。

• メリット1：使い慣れた高機能エディタ機能のフル活用
  VS Codeが持つ強力な編集機能をそのままGAS開発に利用できます。高度なマルチカーソル編集（複数箇所の一括編集）、強力な検索・置換機能、豊富なショートカットキー、柔軟な画面分割などにより、コードの執筆・修正速度が何倍にも跳ね上がります。また、自分好みのテーマやフォントを設定することで、長時間の開発でも疲れにくい環境を作ることができます。
  
  
• メリット2：強力な自動補完（IntelliSense）による品質と速度の向上
  TypeScriptの型定義ファイルを組み合わせることで、VS Code上で「IntelliSense」と呼ばれる超強力な自動補完機能が動作します。SpreadsheetApp. と入力した瞬間に利用可能な全メソッドのリストが一覧表示され、引数や戻り値の情報、概要の説明までツールチップで表示されます。公式リファレンスを検索しなくてもエディタ内で全て完結するため、タイポによる実行時エラーはほぼゼロになり、開発速度は劇的に向上します。
  
  
• メリット3：ローカル環境でのコード資産管理と将来的な拡張性
  コードが自分のパソコン上のローカルファイル（.js や .ts）として保存されるため、誤ってコードを消してしまうリスクが激減します。PC内のローカル検索で過去のコード資産を素早く探し出して使い回すことができるほか、将来的にGitを用いた本格的なバージョン管理や、チームでのコード共有・共同開発へスムーズにステップアップできる土台が整います。
  
  

本連載で達成できる開発プロセスのビフォーアフター

ローカル開発環境（VS Code × clasp）を導入することによって、日々の開発プロセスがどのように変わるのか、そのビフォーアフターを見てみましょう。

• 【Before：ブラウザ版エディタでの開発プロセス】
  
  
  • ブラウザを開き、対象のGoogleスプレッドシートからGASエディタを起動する
    
    
  • メソッド名や引数を忘れるたびに、別タブでGoogle公式ドキュメントを検索して確認する
    
    
  • 正確なスペルに気をつけながら慎重にコードを入力する（それでもタイポでエラーになる）
    
    
  • 過去のコードを参照したい時は、別のGASプロジェクトを別タブで開き、コードをコピペして持ってくる
    
    
  • 修正が終わったら「保存」ボタンを押し、ブラウザ上で実行して動作確認する
    
    
• 【After：VS Codeでのローカル開発プロセス】
  
  
  • VS Codeを起動し、整理されたローカルフォルダでコードを開く
    
    
  • ドット（.）を入力して表示される自動補完候補から目的のメソッドを選択する（タイポゼロ）
    
    
  • 関数の説明や引数の型は、エディタ上に浮かび上がるツールチップでその場で確認する
    
    
  • 画面分割を使って、過去のプロジェクトや別ファイルを横に並べて見ながらサクサク書く
    
    
  • ファイルを保存すると自動でGoogleクラウドへ同期され、すぐにテスト実行に移れる
    
    

一度この快適な開発プロセスを体験すると、もう二度とブラウザ版エディタでの直接編集には戻れなくなります。

次の章では、この理想的な開発体験を実現するために「どのようなツール群を組み合わせるのか」、その全体像とロードマップを紐解いていきましょう。

 

本連載で構築するGASローカル開発環境の全体像

全体構成図：ローカルPCとGoogleクラウドはどう繋がるのか？

VS CodeでのGASローカル開発を始める前に、まずは「手元のパソコン（ローカル環境）」と「Googleのサーバー（クラウド環境）」がどのような関係性で繋がるのか、その全体像を整理しておきましょう。

普段ブラウザでGASを使っているときは、コードの保存も実行もすべてGoogleのサーバー上で行われています。一方、ローカル開発では「コードを書く場所」と「コードが実行される場所」を明確に役割分担させます。

• ローカル環境（自分のPC）：VS Codeを使ってコードを記述し、ファイルとして手元に保存する場所。ストレスのない編集作業や自動補完、ファイル整理をすべてここで行います。
  
  
• クラウド環境（Googleサーバー）：GASのプログラムが実際に動作する場所。スプレッドシートのデータを読み書きしたり、Gmailを送信したりといった処理は、最終的にすべてこちらのサーバー上で行われます。
  
  

この2つの環境を結ぶパイプ役となるのが、Google公式が提供している「clasp（クラスプ）」というコマンドラインツールです。手元のVS Codeで書き上げたコードをclaspを通じてGoogleクラウドへ送信（アップロード）することで、ブラウザ版エディタで直接書いた場合とまったく同じようにGASを動かすことができます。

登場する主要ツールとその役割

本連載の環境構築ではいくつかのツールが登場します。「聞き慣れない名前が多くて難しそう」と感じるかもしれませんが、それぞれのツールが果たす役割は非常にシンプルです。各ツールの役割と関係性を整理してみましょう。

• VS Code（Visual Studio Code）
  
  
  • 役割：コードを快適に書くためのメインツール（テキストエディタ）です。
    
    
  • 解説：高機能な検索、画面分割、デザインのカスタマイズなど、開発者の作業効率を高めるあらゆる機能が集約されています。
    
    
• Node.js（ノード・ジェーエス）
  
  
  • 役割：ローカルPC上でJavaScriptを動かすための「実行基盤（エンジン）」です。
    
    
  • 解説：本来ブラウザ上でしか動かないJavaScriptを、パソコンのOS上で動かせるようにする仕組みです。後述するclaspを自分のPC上で動かすために必須となります。
    
    
• npm（Node Package Manager）
  
  
  • 役割：便利な開発ツールやライブラリをダウンロード・管理するための「ツールストア」です。
    
    
  • 解説：Node.jsをインストールすると自動的に一緒に導入されます。コマンドをひとつ実行するだけで、世界中の開発者が作った便利なツールを自分のPCに取り込むことができます。
    
    
• clasp（Command Line Apps Script Projects）
  
  
  • 役割：ローカルPCとGoogleクラウドを繋ぐ「双方向の架け橋」です。
    
    
  • 解説：Google公式が開発したコマンドラインツールです。ローカルで書いたコードをGASへ同期したり、逆にクラウド上のコードをローカルへ引き込んだりする連携処理を担います。
    
    
• @types/google-apps-script（型定義ファイル）
  
  
  • 役割：VS CodeにGAS専用命令の辞書を教える「自動補完の拡張データ」です。
    
    
  • 解説：SpreadsheetApp や GmailApp といったGAS独自のオブジェクト情報をVS Codeに読み込ませることで、超強力な入力補完（IntelliSense）を実現します。
    
    

これらすべてのツールが噛み合うことで、快適なローカル開発環境が完成します。

完成までの4ステップ・ロードマップ

本連載では、環境構築から実務での活用までをスムーズに進められるよう、全4回のステップに分けて着実に環境を作り上げていきます。

• STEP 1（第1回・今回）：Node.jsの導入とターミナル操作の基礎習得
  
  
  • 内容：すべての土台となるNode.jsをPCにインストールし、ツール操作に必要な「ターミナル（コマンドライン）」の基礎コマンドを身につけます。
    
    
• STEP 2（第2回）：claspのインストールとGoogleアカウントの連携認証
  
  
  • 内容：npmを使ってclaspをPCに導入し、Google Apps Script APIの有効化とGoogleアカウントとのセキュリティ連携（OAuth認証）を行います。
    
    
• STEP 3（第3回）：ローカル・クラウド間の双方向同期（push / pull / watch）のマスター
  
  
  • 内容：VS Codeで書いたコードをGASに反映する「push」、クラウド側から取得する「pull」、ファイルを保存した瞬間に自動同期する「watch」といった実践的ワークフローを確立します。
    
    
• STEP 4（第4回）：型定義ファイルの導入によるVS Code自動補完環境の完成
  
  
  • 内容：GAS用の型定義パッケージを導入し、VS Code上でGASの独自オブジェクトやメソッドが爆速で補完される最高の開発環境を完成させます。
    
    

一歩ずつ順番に進めていけば、確実にプロ仕様の開発環境が手に入ります。

コマンドライン恐怖症を克服！VS Code内蔵ターミナルの基本操作

ターミナル（コマンドライン）とは？GUIとCLIの違い

ローカル開発環境の構築において、避けて通れないのが「ターミナル」と呼ばれる画面でのコマンド入力です。「黒い画面に英数字を打ち込む作業はハードルが高い」「間違えたコマンドを打ったらパソコンが壊れるのでは」と恐怖心を感じる初心者の方は少なくありません。

しかし、構造を理解してしまえば、ターミナルは決して怖いものではありません。私たちが普段行っているパソコンの操作方法は、大きく分けて以下の2つに分類されます。

• GUI（Graphical User Interface / グラフィカル・ユーザー・インターフェース）
  
  
  • 操作方法：マウスを使ってアイコンをクリックしたり、フォルダをドラッグ＆ドロップしたりして視覚的に操作する方式です。
    
    
  • 特徴：直感的でわかりやすい反面、決まった操作を何十回も繰り返したり、複数のツール同士を連携させたりする作業には時間がかかります。
    
    
• CLI（Command Line Interface / コマンド・ライン・インターフェース）
  
  
  • 操作方法：キーボードから特定の「命令テキスト（コマンド）」を打ち込んでパソコンに指示を出す方式です。ターミナルはこのCLI操作を行うための画面です。
    
    
  • 特徴：文字入力が必要なため最初は慣れが必要ですが、操作が正確で一瞬で完了し、外部ツールとの連携や自動化処理において圧倒的なスピードを発揮します。
    
    

claspのような開発ツールは、CLIで指示を出すことを前提に作られています。マウス操作の代わりに「指示書（コマンド）をテキストで手渡ししているだけ」と考えると、少し親しみやすくなるのではないでしょうか。

VS Code内蔵ターミナルの起動と画面の見方

通常、ターミナルを使う際はOS標準のアプリ（WindowsのPowerShellやMacのターミナル）を別に立ち上げますが、VS Codeには最初からエディタ内部でターミナルを動かせる「内蔵ターミナル」が備わっています。画面を切り替える必要がないため、非常に効率的です。

内蔵ターミナルの起動方法と画面の見方を確認しておきましょう。

• 内蔵ターミナルの起動方法
  
  
  • 上部メニューから「ターミナル」→「新しいターミナル」を選択します。
    
    
  • または、ショートカットキー Ctrl + Shift + @ （Macの場合は Ctrl + @ または Cmd + @ ）を押すことで、エディタの下部にターミナル画面が立ち上がります。
    
    
• プロンプトの読み解き方
  
  
  • ターミナルが開くと、 PS C:\Users\YourName\project> や user@MacBook % といった文字が表示されます。これを「プロンプト」と呼びます。
    
    
  • プロンプトに表示されているパス（フォルダの場所）は、「現在ターミナルが操作対象として注目している場所（カレントディレクトリ）」を表しています。コマンドを打ち込むと、この表示されているフォルダに対して指示が実行されます。
    
    
• OSごとのシェルの違い（補足）
  
  
  • ターミナルの裏側で動いているプログラム（シェル）はOSによって異なります。Windowsでは標準で「PowerShell」、Macでは「zsh」が選択されます。本連載で紹介する基本コマンドやclaspの操作は、どのOS環境でも同様に動作しますのでご安心ください。
    
    

これだけ覚えれば大丈夫！必須の基本コマンド4選

ターミナル操作で使うコマンドは無数に存在しますが、環境構築や日常のGAS開発で使うものはほんの数種類だけです。まずは以下の基本コマンド4つを押さえておけば困ることはありません。

• cd（Change Directory / ディレクトリの移動）
  
  
  • 役割：操作対象とするフォルダ（ディレクトリ）を移動します。
    
    
  • 使い方： cd フォルダ名 と入力すると指定したフォルダの中へ移動します。1つ上の親フォルダに戻りたい場合は cd .. と入力します。
    
    
• pwd または cd（現在位置の確認）
  
  
  • 役割：自分が今パソコンの中のどのフォルダにいるか、正確な住所（パス）を表示します。
    
    
  • 使い方：MacやWindowsのPowerShellでは pwd と入力します。現在いる場所を見失った際に役立ちます。
    
    
• ls または dir（ファイル一覧の表示）
  
  
  • 役割：現在いるフォルダの中に、どんなファイルやサブフォルダが存在するかを一覧表示します。
    
    
  • 使い方：MacやWindowsのPowerShellでは ls と入力します（Windowsのコマンドプロンプトでは dir ）。目的のファイルがその場所にあるか確認する際によく使います。
    
    
• clear または cls（画面のリセット）
  
  
  • 役割：コマンドの実行結果やエラーメッセージで散らかったターミナル画面の文字を一瞬で綺麗に消去します。
    
    
  • 使い方：MacやWindowsのPowerShellでは clear と入力します（Windowsのコマンドプロンプトでは cls ）。画面が見づらくなった時にいつでも実行できます。
    
    

ターミナル操作を劇的にスムーズにするプロのテクニック

コマンドを毎回1文字ずつ手入力するのは大変ですし、タイポの原因にもなります。プロのエンジニアが全員使っている、ターミナル操作を格段に速く・正確にする2つの必須テクニックを紹介します。

• テクニック1：Tabキーによる自動補完
  
  
  • フォルダ名やファイル名を途中まで入力した状態でキーボードの Tab キーを押すと、残りの文字列が自動的に補完されます。
    
    
  • 例えば project-gas というフォルダへ移動したい場合、 cd pro あたりまで入力して Tab を押すだけで全文字が入力されます。入力の手間が省けるだけでなく、名前のスペルミスを100%防ぐことができる最強の機能です。
    
    
• テクニック2：上下矢印キー（ ↑ / ↓ ）によるコマンド履歴の呼び出し
  
  
  • キーボードの ↑ （上矢印）キーを押すと、過去に実行したコマンドの履歴が順番に呼び出されます。
    
    
  • 一度実行した長いコマンドをもう一度実行したい場合や、少しだけ修正して再実行したい場合は、 ↑ キーで履歴を呼び出して Enter を押すだけで完了します。
    
    

この2つのテクニックを活用するだけでも、ターミナルへの苦手意識は一気に解消されるはずです。

次章では、いよいよ本開発環境のエンジンとなる「Node.js」と「npm」のインストール作業へと入っていきましょう！

 

ローカル開発の土台！Node.jsとnpmのインストールと動作確認

なぜGAS開発なのに「Node.js」が必要なのか？

「Google Apps Script（GAS）はGoogleの仕組みなのに、なぜまったく別のプログラムである『Node.js』を自分のパソコンにインストールしなければならないのだろう？」と疑問に思う方もいるかもしれません。

この理由を理解するために、まずはNode.jsの正体と、GASローカル開発の要となるツール「clasp」との関係性を紐解いていきましょう。

• Node.jsの正体：本来、JavaScriptというプログラミング言語は、Google ChromeやMicrosoft Edgeといった「Webブラウザの中」だけで動作するように設計されていました。そのJavaScriptを、ブラウザの枠から飛び出させて「パソコンのOS上で直接動かせるようにした実行基盤（エンジン）」がNode.jsです。
  
  
• Google公式ツール「clasp」との関係：第2章で紹介した通り、ローカル環境とGoogleクラウドを繋ぐ架け橋となるGoogle公式ツールが「clasp」です。実は、このclasp自体が「Node.js上で動作するプログラム」として開発・公開されています。
  
  

つまり、あなたのパソコン上でclaspというツールを動かすための「土台（エンジン）」としてNode.jsが不可欠になるわけです。スマートフォンに例えるなら、claspが便利な「アプリ」で、Node.jsがそれを動かすための「OS」のような関係だとイメージすると分かりやすいでしょう。

Node.jsのダウンロード（LTS版の選択）

それでは、さっそくNode.jsをPCにダウンロードしましょう。ブラウザを開き、Node.jsの公式サイトにアクセスします。

公式サイトのトップページを開くと、ダウンロードボタンが2つ並んで表示されます。

• LTS版（Long Term Support：推奨版）：長期間のサポートが保証されている安定版です。機能追加よりも安全面や動作の安定性が最優先されており、開発現場で広く利用されています。
  
  
• Current版（最新版）：最新の追加機能がいち早く試せるバージョンです。先進的な機能が試せる反面、予期せぬ不具合や外部ツールとの相性問題が発生するリスクがあります。
  
  

初心者の方、あるいは仕事で安全かつ確実に環境を構築したい方は、迷わず「LTS版」を選択してください。

ボタンをクリックすると、ご自身のOS（WindowsまたはMac）に合ったインストーラーファイル（Windowsの場合は .msi ファイル、Macの場合は .pkg ファイル）が自動的にダウンロードされます。

Node.jsのインストール手順

ダウンロードが完了したら、ファイルを開いてインストーラーを起動します。

基本的には、画面の指示に従って「Next（次へ）」をクリックしていくだけで問題ありません。画面ごとのポイントを確認しながら進めましょう。

1. セットアップウィザードの開始：ウェルカム画面が表示されたら「Next」をクリックします。
   
   
2. ライセンス規約の同意：規約を確認し、「I accept the terms in the License Agreement（規約に同意する）」にチェックを入れて「Next」をクリックします。
   
   
3. インストール先の指定：プログラムの保存場所を選択する画面が表示されます。標準設定（デフォルトのパス）のままで問題ありませんので「Next」をクリックします。
   
   
4. コンポーネントの選択：どの機能をインストールするか選ぶ画面です。ここにはPackage Managerである「npm」や「Add to PATH（環境変数への追加）」が含まれています。設定を変更せずデフォルトのまま「Next」をクリックします。
   
   
5. 追加ツールのインストール確認（Windowsのみ）：ビルドツール等の追加を求めるチェックボックスが表示されることがありますが、通常のGAS開発であればチェックを入れずに「Next」へ進んで大丈夫です。
   
   
6. インストールの実行：「Install」ボタンをクリックするとインストール処理が始まります。完了画面が表示されたら「Finish」をクリックしてウィザードを閉じます。
   
   

このインストール作業によって、Node.js本体だけでなく、パッケージ管理ツールである「npm」も一緒にパソコンへ導入されます。

インストール完了の動作確認（バージョンチェック）

インストールが無事に終わったら、正しくセットアップできたかVS Codeのターミナルを使って動作確認を行いましょう。

VS Codeを起動し、内蔵ターミナルを開いて以下のコマンドを入力してみます。

まずはNode.jsのバージョン確認コマンドです。

Bash

node -v

コマンドを入力して Enter キーを押した際、ターミナルに v20.x.x や v22.x.x のように「v」から始まる数字（バージョン番号）が表示されれば、Node.jsのインストールは成功です。

続いて、一緒に導入されたパッケージマネージャー「npm」のバージョンも確認します。

Bash

npm -v

こちらも同様に 10.x.x のような数字が表示されればバッチリです。

もし「コマンドが見つかりません」といったエラーメッセージが表示された場合は、次章のトラブルシューティングを参考に解決を図りましょう。

【初心者が陥りがちなトラブルとエラー対処】

セットアップ作業では、環境やOSの設定によって思いがけないエラーが発生することがあります。ここでは、第1回の工程で初心者が特につまづきやすい代表的なトラブルとその明確な解決策をまとめました。

「node: コマンドが見つかりません」と表示される場合

Node.jsのインストール直後、ターミナルで node -v や npm -v を実行した際、「node は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません」（Windows）、あるいは「command not found: node」（Mac）というエラーが出るケースが多発します。

• 原因：Node.jsのインストール前に起動していたVS Codeやターミナル画面には、新しく導入されたNode.jsの読み込み情報（パス設定）がまだ反映されていないことが原因です。
  
  
• 対処法：
  
  
  1. 一度VS Codeを完全に終了（ウィンドウを閉じる）します。
     
     
  2. 再度VS Codeを起動し、新しい内蔵ターミナルを開きます。
     
     
  3. もう一度 node -v を入力して実行します。
     ほとんどの場合、アプリの再起動によって環境変数（パス）が再読み込みされ、正常にバージョンが表示されるようになります。
     
     

Windowsで「スクリプトの実行がシステムで無効になっている」エラーが出た場合

Windows環境において、ターミナル（PowerShell）で各種コマンドを実行した際、赤文字で「このシステムではスクリプトの実行が無効になっているため、ファイルを読み込むことができません」という長文のエラーが表示されることがあります。

• 原因：Windows標準のPowerShellには、悪意あるプログラムの自動実行を防ぐためのセキュリティ制限（ExecutionPolicy）が設定されており、これがnpm等のスクリプト実行をブロックしてしまうためです。
  
  
• 対処法：
  
  
  1. VS Codeを一旦閉じ、Windowsのスタートメニューから「PowerShell」を検索します。
     
     
  2. 表示されたPowerShellアイコンを右クリックし、「管理者として実行」を選択します。
     
     
  3. 開いた青い画面で、以下のコマンドを入力して Enter を押します。
     
     

PowerShell

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

1. 変更を確認するメッセージが表示されたら、キーボードの Y を入力して Enter を押します。
   
   
2. 管理者用のPowerShellを閉じ、通常のVS Codeに戻ってターミナル操作を再開します。これでセキュリティ制限が解除され、コマンドが正常に通るようになります。
   
   

ターミナルで日本語が文字化けする場合

ターミナル内の案内メッセージやファイル名に含まれる日本語が ??? や意味不明な記号（文字化け）で表示されてしまう場合の対処法です。

• 原因：VS Codeのターミナルが想定している文字コード（エンコード）設定と、OS側の標準出力文字コードが一致していないために起こります。
  
  
• 対処法：
  
  
  • 文字コードのUTF-8化：VS Codeの右下ステータスバーにある文字コード表示が「UTF-8」になっているか確認します。
    
    
  • Windows環境での手動指定：PowerShellを利用している場合、ターミナル上で chcp 65001 というコマンドを実行すると、ターミナルの表示モードが即座にUTF-8に切り替わり、文字化けが解消されます。
    
    

おわりに / 次回予告

第1回の振り返り

お疲れ様でした！「第1回：なぜローカル開発なのか？VS CodeでのGAS開発ロードマップとNode.jsの導入」の工程はすべて完了です。

今回の記事を通じて、みなさんは以下の大きな一歩を踏み出しました。

• ブラウザ版GASエディタの限界と、VS Codeを使ったローカル開発の圧倒的なメリットを理解した
  
  
• ローカルPCとGoogleクラウドがどのように繋がるのか、ツール構成とロードマップを把握した
  
  
• ターミナルの起動方法やプロンプトの見方、基本コマンド4選を習得し、操作への恐怖心を克服した
  
  
• ローカル開発の実行エンジンとなる「Node.js」と「npm」のインストールおよび動作確認を終えた
  
  

これで、ローカルで本格的な開発を行うための「土台作り」は見事に完成しました。

次回予告

土台が整い、いよいよ次回は手元のVS CodeとGoogleクラウドを物理的に接続する実践フェーズへと進みます！

次回のテーマは、「【第2回】Google公式ツール『clasp』の導入とGASプロジェクトの連携」です。

• npmを使ったGoogle公式ツール「clasp」のインストール手順
  
  
• Googleアカウント側での「Google Apps Script API」有効化設定（必須のセキュリティ設定）
  
  
• clasp login コマンドを使った安全なOAuthアカウント認証
  
  
• ローカルからの新規GASプロジェクト作成（create）と、既存プロジェクトの取り込み（clone）
  
  

手元のVS Codeから指示を出し、Googleドライブ上に新しいGASプロジェクトが自動生成された瞬間の感動を、ぜひ一緒に体験しましょう！次回もお楽しみに！