Next.js インストール

始める前に、Node.js と npm がインストールされていることを確認してください。以下のコマンドでインストールされているかどうかを確認できます:

node -v
npm -v

お使いのシステムがまだ Node.js および NPM をサポートしていない場合は、当サイトのNode.js チュートリアルを参照できます。。

国内では npm の速度が非常に遅いため、淘宝がカスタマイズした cnpm(gzip 圧縮サポート)コマンドラインツールをデフォルトの npm の代わりに使用できます:

$ npm install -g cnpm --registry=https://registry.npmmirror.com
$ npm config set registry https://registry.npmmirror.com

これで cnpm コマンドを使用してモジュールをインストールできます:

$ cnpm install [name]

詳細情報は以下を参照してください:http://npm.taobao.org/。


create-react-app を使用して Next.js 開発環境をすばやく構築する

Next.js は、プロジェクトを迅速に構築するための公式スキャフォールディングツール create-next-app を提供しています。

create-react-app は Facebook 由来であり、このコマンドを使用すると設定なしで Next.js 開発環境をすばやく構築できます。

create-react-app が自動的に作成するプロジェクトは Webpack + ES6 に基づいています。

以下のコマンドを実行してプロジェクトを作成します:

npx create-next-app@latest my-next-app

インストール時に以下のプロンプトが表示されます。そのまま Enter キーを押し続けてください:

Would you like to use TypeScript? No / Yes
Would you like to use ESLint? No / Yes
Would you like to use Tailwind CSS? No / Yes
Would you like your code inside a `src/` directory? No / Yes
Would you like to use App Router? (recommended) No / Yes
Would you like to use Turbopack for `next dev`?  No / Yes
Would you like to customize the import alias (`@/*` by default)? No / Yes
What import alias would you like configured? @/*

    npx は、パッケージ内のバイナリファイルをグローバルインストールせずに実行するための Node.js ツールです。

  • 使用create-next-appスキャフォールディングツールを使用して新しい Next.js プロジェクトを作成します。
  • my-next-appはプロジェクトの名前です。必要に応じて任意の名前に変更できます。
  • プロジェクトに必要な依存関係を自動的にインストールします。

このコマンドを実行すると、create-next-app は自動的に以下の操作を実行します:

  • my-next-app という名前のフォルダーを作成します。
  • プロジェクトを初期化し、必要な依存関係をインストールします。
  • app フォルダー、public フォルダー、package.json ファイルなどを含む基本的なプロジェクト構造を作成します。

作成が完了したら、プロジェクトディレクトリに移動します:

cd my-next-app

プロジェクトディレクトリで以下のコマンドを実行して開発サーバーを起動します:

npm run dev

または yarn を使用する場合:

yarn dev

開発サーバーはデフォルトでhttp://localhost:3000で実行されます。ブラウザを開いてアクセス http://localhost:3000すると、Next.js のデフォルトのウェルカムページが表示されるはずです。

app ディレクトリ内の page.tsx ファイルを変更できます。変更後のコードは次のとおりです:

app/page.tsx

export default function Home() {
    return <div>Hello, World!</div>;
}

アクセス http://localhost:3000すると、以下のように表示されます:

Hello, World!

手動での Next.js インストール

手動で新しい Next.js アプリケーションを作成するには、まず必要なパッケージをインストールします:

npm install next@latest react@latest react-dom@latest

次に、package.json ファイルを開いて以下のスクリプトを追加します:

package.json ファイル:

{
  "scripts": {
    "dev": "next dev",        // 開発モードで Next.js を起動します
    "build": "next build",    // 本番用にアプリケーションをビルドします
    "start": "next start",    // Next.js 本番環境サーバーを起動します
    "lint": "next lint"       // Next.js の組み込み ESLint を設定します
  }
}

これらのスクリプトは、アプリケーション開発のさまざまな段階を表しています:

  • dev:実行するnext dev、開発モードで Next.js を起動します。
  • build:実行するnext build、本番環境用にアプリケーションをビルドします。
  • start:実行するnext start、Next.js 本番サーバーを起動します。
  • lint:実行するnext lint、Next.js の組み込み ESLint 設定を行います。

アプリケーションディレクトリの作成

Next.js はファイルシステムルーティングを使用します。つまり、アプリケーションのルートはファイル構造によって決まります。

app フォルダーを作成し、layout.tsx と page.tsx ファイルを追加します。ユーザーがアプリケーションのルートパス/にアクセスすると、これらのファイルがレンダリングされます。

ルートレイアウトファイルの作成

にapp/layout.tsxにルートレイアウトファイルを作成し、必要な<html>と<body>タグを含めます:

例

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}

ホームページファイルの作成

最後に、app/page.tsx にホームページファイルを作成し、初期コンテンツを追加します:

例

export default function Page() {
  return <h1>Hello, Next.js!</h1>
}

注意事項

  • もし作成し忘れた場合はlayout.tsx、Next.js は開発サーバー(next dev)の実行時に、このファイルを自動的に作成します。
  • プロジェクトのルートディレクトリでオプションとして使用できますsrcディレクトリを利用して、アプリケーションコードと設定ファイルを分離します。

public フォルダーの作成(オプション)

プロジェクトのルートディレクトリにpublicフォルダーを作成して、画像やフォントなどの静的リソースを保存できます。publicフォルダー内のファイルは/パスを使用して参照できます。

これで、手動インストールと基本的な Next.js プロジェクト構造の初期化が完了しました。

開発サーバーの実行

以下のコマンドを実行して開発サーバーを起動します:

npm run dev

http://localhost:3000 にアクセスしてアプリケーションを確認します。

編集してapp/page.tsxファイルを保存すると、ブラウザで更新された結果を確認できます。

その他の拡張