vite-tsconfig-pathsを使用すると、ViteプロジェクトでTypeScriptのパスエイリアスを簡単に設定できます。以下に、その手順と具体的なインポート例を説明します。

1. `vite-tsconfig-paths`を使ったエイリアス設定方法

ステップ1: パッケージのインストール

まず、開発環境にvite-tsconfig-pathsをインストールします。

npm install -D vite-tsconfig-paths

ステップ2: `tsconfig.json`の設定

次に、プロジェクトのルートディレクトリにあるtsconfig.jsonファイルに、エイリアスの設定を追加します。

{
  "compilerOptions": {
    "baseUrl": "./",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

この設定により、@/をsrc/ディレクトリに対応させることができます。

ステップ3: `vite.config.ts`の設定

最後に、vite.config.tsファイルでvite-tsconfig-pathsプラグインを読み込み、Viteのプラグインとして登録します。

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import tsconfigPaths from 'vite-tsconfig-paths';

export default defineConfig({
  plugins: [
    react(),
    tsconfigPaths()
  ]
});

これにより、tsconfig.jsonで設定したパスエイリアスがViteのビルドプロセスでも適用されます。

2. `src/App.tsx`でのインポート例

上記の設定を行った後、src/App.tsxでのインポートは以下のように記述できます。

import React from 'react';
import Header from '@/components/Header';
import Footer from '@/components/Footer';
import { fetchData } from '@/utils/api';

const App: React.FC = () => {
  // コンポーネントのロジック
  return (
    <div>
      <Header />
      {/* 他のコンポーネントや要素 */}
      <Footer />
    </div>
  );
};

export default App;

ここで、@/はプロジェクトのsrc/ディレクトリを指しています。したがって、@/components/Headerはsrc/components/Headerを、@/utils/apiはsrc/utils/apiをそれぞれ参照します。このようにエイリアスを使用することで、深い階層の相対パスを避け、コードの可読性と保守性を向上させることができます。

以上の手順で、vite-tsconfig-pathsを使用したエイリアス設定と、その具体的なインポート方法を実現できます。