技術共有

한어Русский языкEnglishFrançaisIndonesianSanskrit日本語DeutschPortuguêsΕλληνικάespañolItalianoSuomalainenLatina

導入

Yarn は、プロジェクトの依存関係を管理するために Node.js と緊密に統合されている人気のある JavaScript パッケージ マネージャーです。ただし、開発プロセス中に、開発者は Node.js バージョンの非互換性の問題に遭遇し、Yarn ランタイム エラーが発生する可能性があります。この記事では、開発者がこれらの問題を診断して解決するのに役立つ詳細なガイドを提供します。

Node.js のバージョンの問題を理解する

Node.js バージョンの問題は通常、次の状況で発生します。

1. プロジェクトは Node.js の特定のバージョンに依存します: 一部のパッケージは、特定のバージョンの Node.js とのみ互換性がある場合があります。
2. グローバル Node.js のバージョンがプロジェクトと一致しません: 開発者は、プロジェクトと互換性のない Node.js バージョンをグローバル環境にインストールした可能性があります。
3. Node.js バージョン管理ツールとの競合:のように使用します nvm またはn バージョン管理ツールの待機中に、不適切なバージョン切り替えによる問題が発生する可能性があります。

問題を診断する

問題を解決するには、まず問題を診断する必要があります。 Node.js のバージョンの問題を診断する手順は次のとおりです。

1. プロジェクトの依存関係を確認する：チェック package.json ファイルの中にengines プロジェクトが依存する Node.js バージョンを確認するためのフィールド。
2. 現在の Node.js バージョンを表示する:コマンドラインから実行 node -v 現在の Node.js バージョンを表示します。
3. Yarn のバージョンを確認する：走る yarn --version Yarn のバージョンを確認し、Node.js のバージョンと互換性があることを確認します。

Node.js バージョン管理ツールの使用

次のような Node.js バージョン管理ツールを使用します。 nvm(Node Version Manager) は、開発者が異なるプロジェクト間で Node.js バージョンを切り替えるのに役立ちます。

nvmをインストールする

macOS または Linux に nvm をインストールします。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
1

または wget を使用します。

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
1

Windows では、次のように使用できます。 nvm-windows。

nvm を使用して Node.js バージョンのインストールと切り替えを行う

特定のバージョンの Node.js をインストールします。

nvm install 14.17.0  # 以 Node.js 14.17.0 为例
1

特定のバージョンの Node.js に切り替えます。

nvm use 14.17.0
1

.nvmrc ファイルの使用

.nvmrc このファイルでは、プロジェクトに必要な Node.js バージョンを指定できます。プロジェクトのルートディレクトリに作成.nvmrc ファイルを作成し、必要なバージョン番号を書き込みます。

14.17.0
1

次に、次のコマンドを実行して使用します .nvmrc ファイルで指定された Node.js バージョン:

nvm install
1

依存関係のバージョンをロックする

糸を使う yarn.lock ファイルまたはnpmpackage-lock.json ファイルは依存関係のバージョンをロックして、異なる環境で同じ依存関係のバージョンが使用されるようにすることができます。

Yarn.lock を使用する

走る yarn install Yarn は自動的に作成または更新されますyarn.lock 書類。バージョンの競合が発生した場合には、必ずこのファイルを更新してください。

依存関係の強制更新

新しい Node.js バージョンに一致するように依存関係を更新する必要がある場合は、次のコマンドを使用できます。

yarn upgrade
1

Yarn ランタイム エラーの処理

Yarn の実行中にエラーが発生した場合は、まずエラー メッセージを確認して、Node.js のバージョンに関連しているかどうかを判断します。その後、エラーメッセージに基づいて適切な解決策を講じてください。

エラー処理の例

Yarn の実行時に、依存関係が現在の Node.js バージョンと互換性がないことを通知するとします。

error An unexpected error occurred: "package-name" requires a peer of "other-package"@"^2.0.0"
1

この時点で、正しいものを更新またはインストールする必要があります。 other-package バージョン：

yarn add other-package@^2.0.0
1

結論は

Yarn 実行時の Node.js バージョンの問題を解決するには、開発者がプロ​​ジェクトの依存関係、Node.js バージョン、およびバージョン管理ツールについて一定の理解を持っている必要があります。これらの問題は、Node.js バージョン管理ツールを使用し、依存関係のバージョンをロックし、ランタイム エラーを適切に処理することで効果的に回避および解決できます。コード バージョンの互換性を維持し、プロジェクトの依存関係を更新することが、プロジェクトをスムーズに実行するための鍵であることに注意してください。

参考文献

• Yarn 公式ドキュメント: https://classic.yarnpkg.com/en/docs/
• Node.js 公式ドキュメント: https://nodejs.org/en/docs/
• nvm 公式 GitHub リポジトリ: https://github.com/nvm-sh/nvm

この記事で提供されているガイダンスに従うことで、開発者は Yarn ランタイムでの Node.js バージョンの問題をより自信を持って管理し、解決できるようになります。