Vue CLI を利用したモダンなフロントエンドプロジェクトの初期構築

Vue.js は、宣言的レンダリングとコンポーネントアーキテクチャを採用した JavaScript フレームワークです。データとビューのバインディングにより DOM 操作の煩雑さを抽象化し、ビジネスロジックの記述に集中できる環境を提供します。ここでは、公式の CLI ツールを活用して、本格的な開発プロジェクトをゼロからセットアップする手順を解説します。

開発環境の整備

まず、ローカルマシンに Node.js ランタイムを配備します。公式配布サイトから長期支持版(LTS)を取得し、インストーラーに従ってセットアップを完了させてください。これにより、パッケージ管理ツールである npm も同時に利用可能になります。

ネットワークの安定性を確保するため、レジストリを国内のミラーサイトへ切り替える設定を行います。グローバル設定を変更する代わりに、プロジェクトルートに設定ファイルを作成して特定のミラーを指定する方法を採用します。

echo "registry=https://registry.npmmirror.com" > .npmrc
npm install -g @vue/cli

上記コマンドにより、プロジェクト生成に必要な CLI パッケージがシステムに導入されます。

プロジェクトの生成と構成

任意の作業ディレクトリに移動し、CLI ツールを呼び出して新しいアプリケーションの骨格を作成します。ここではプロジェクト名を app-skeleton とします。

vue create app-skeleton

コマンド実行後、対話型ウィザードが起動します。プリセットの選択画面では「Manually select features」を指定し、必要なプラグインを個別に有効化します。通常、トランスパイラ(Babel)、ルーティング(Vue Router)、ステート管理、およびリンター(ESLint)をトグル形式でオンにすることで、実務に耐えうる構成が得られます。

設定が確定すると、指定した名前でディレクトリが作成され、依存関係のダウンロードと初期ファイルの配置が自動実行されます。

ディレクトリ構造の解説

生成されたプロジェクトは、以下のような階層で整理されています。

  • src/:アプリケーションの中枢となるソースコードを格納。すべての開発作業は主にこの配下で行います。
  • src/assets/:画像、フォント、スタイルシートなどの静的リソースを配置。
  • src/components/:再利用可能な UI コンポーネントのテンプレートとスクリプトを管理。
  • src/router/:URL パスと画面遷移のルーティング定義を記述。
  • src/App.vue:ルートコンポーネント。アプリ全体のレイアウト構造の起点となります。
  • main.js:エントリポイント。Vue インスタンスの生成と DOM マウント処理を実行。
  • package.json:スクリプトコマンドの定義と、外部ライブラリの依存関係メタデータを保持。

開発サーバーの起動と検証

ディレクトリへ移動し、依存パッケージのインストールが完了していることを確認したら、開発用ビルドプロセスを起動します。

cd app-skeleton
npm run serve

コンパイルが正常に終了すると、ローカルホストの指定ポート(デフォルトでは http://localhost:8080)で Web サーバーが起動します。ブラウザで当該アドレスにアクセスし、初期のダッシュボード画面が正しく描画されれば、環境構築は完了です。以降はソースコードの編集と保存を行うだけで、変更内容がリアルタイムでブラウザに反映されます。

タグ: vue.js vue-cli javascript npm frontend-development

7月30日 07:15 投稿