<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="1" class="code-line"><strong>追記: 2024-09-10</strong><br>
その後、corepack は Node.js から削除されることになったので現在は非推奨です。<br>
補足記事: <a href="https://zenn.dev/monicle/articles/b7a9314f9f1efb" target="_blank">RIP 2024年こそ corepack を使おうとしたら終わった</a></p>
</div></aside>
<p data-line="6" class="code-line">普段の開発では nodenv を使って各プロジェクトのバージョンに合わせた Node.js をインストールしています。その後、各プロジェクトの README や package.json を頼りに <code>npm install -g yarn</code> や <code>npm install -g pnpm</code> することが多いです。</p>
<p data-line="8" class="code-line">先日、同僚から「最近は corepack 使ってますよ」と教えてもらったので、「おーもう実務で使えるのかー」と一気にモチベーションが上がったので corepack 使っていきたいと思います。</p>
<p data-line="10" class="code-line">まずはこちらの鉄板記事でおさらい。</p>
<p data-line="12" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0e1dfc121b3a6" src="https://embed.zenn.studio/card#zenn-embedded__0e1dfc121b3a6" data-content="https%3A%2F%2Fzenn.dev%2Fteppeis%2Farticles%2F2021-05-corepack" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://zenn.dev/teppeis/articles/2021-05-corepack" style="display:none" target="_blank">https://zenn.dev/teppeis/articles/2021-05-corepack</a></p>
<p data-line="14" class="code-line">corepack を使っていくということは yarn や pnpm の管理を corepack に任せるということなので、まずは global install しているそれらを削除して実験してみます。</p>
<h2 id="yarn-%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A7%E6%A4%9C%E8%A8%BC" data-line="16" class="code-line">
<a class="header-anchor-link" href="#yarn-%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A7%E6%A4%9C%E8%A8%BC" aria-hidden="true"></a> yarn を使っているプロジェクトで検証</h2>
<p data-line="18" class="code-line">とある yarn を使っているプロジェクト</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="20">$ <span class="token function">node</span> <span class="token parameter variable">-v</span>
v18.19.0

$ <span class="token function">yarn</span> <span class="token parameter variable">-v</span>
<span class="token number">1.22</span>.19

$ corepack <span class="token parameter variable">-v</span>
<span class="token number">0.22</span>.0
</code></pre></div><p data-line="31" class="code-line">yarn を削除してみます。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="33">$ <span class="token function">npm</span> uninstall <span class="token parameter variable">-g</span> <span class="token function">yarn</span>
</code></pre></div><p data-line="37" class="code-line">いなくなりました。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="39">$ <span class="token function">yarn</span>
nodenv: yarn: <span class="token builtin class-name">command</span> not found
</code></pre></div><p data-line="44" class="code-line"><code>package.json</code> に <code>packageManager</code> フィールドを追加します。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="46">"packageManager": "yarn@1.22.19"
</code></pre></div><p data-line="50" class="code-line"><code>corepack enable yarn</code> はまだ必須なのかなーと調べるために、あえてこのまま <code>yarn</code> 実行。まだだめ。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="52">$ <span class="token function">yarn</span>
nodenv: yarn: <span class="token builtin class-name">command</span> not found
</code></pre></div><p data-line="57" class="code-line"><code>corepack enable yarn</code> します。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="59">$ corepack <span class="token builtin class-name">enable</span> <span class="token function">yarn</span>
</code></pre></div><p data-line="63" class="code-line">そして、おもむろに yarn と叩くと...</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="65">$ <span class="token function">yarn</span>
<span class="token function">yarn</span> <span class="token function">install</span> v1.22.19
<span class="token punctuation">[</span><span class="token number">1</span>/5<span class="token punctuation">]</span> 🔍  Validating package.json<span class="token punctuation">..</span>.
<span class="token punctuation">[</span><span class="token number">2</span>/5<span class="token punctuation">]</span> 🔍  Resolving packages<span class="token punctuation">..</span>.
success Already up-to-date.
✨  Done <span class="token keyword">in</span> <span class="token number">0</span>.20s.
</code></pre></div><p data-line="74" class="code-line">うおおおおおおおおおおおおお！勝手にインストールされて実行されました！わかっていても感動する🎉</p>
<h2 id="pnpm-%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A7%E6%A4%9C%E8%A8%BC" data-line="76" class="code-line">
<a class="header-anchor-link" href="#pnpm-%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A7%E6%A4%9C%E8%A8%BC" aria-hidden="true"></a> pnpm を使っているプロジェクトで検証</h2>
<p data-line="78" class="code-line">とある pnpm を使っているプロジェクト</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="80">$ <span class="token function">node</span> <span class="token parameter variable">-v</span>
v18.9.0

$ <span class="token function">pnpm</span> <span class="token parameter variable">-v</span>
<span class="token number">8.7</span>.0

$ corepack <span class="token parameter variable">-v</span>
<span class="token number">0.17</span>.1
</code></pre></div><p data-line="91" class="code-line">corepack のバージョンがちょっと古い 0.17 なのは、node が 18.9 と、先ほどのプロジェクトの 18.19 よりも node 自体がちょっと古いからですかね。</p>
<p data-line="93" class="code-line">pnpm を削除してみます。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="95">$ <span class="token function">npm</span> uninstall <span class="token parameter variable">-g</span> <span class="token function">pnpm</span>
</code></pre></div><p data-line="99" class="code-line">あれ、いなくならない</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="101">$ <span class="token function">pnpm</span>
Version <span class="token number">8.7</span>.0
</code></pre></div><p data-line="106" class="code-line">よくよく確認すると...おおお！こちらの既存プロジェクトでは既に <code>"packageManager": "pnpm@8.7.0"</code> が <code>package.json</code> に定義されていました。さすが同僚氏！</p>
<p data-line="108" class="code-line">しかも過去に無意識で <code>corepack enable pnpm</code> をしたことがあったことも、この記事を書きながら検証していて気付きました。なんだったら Dockerfile ではかなり前から当たり前に使われていて、corepack って既に常識にすらなっていたんですね。知らなかった！</p>
<h2 id="corepack-use" data-line="110" class="code-line">
<a class="header-anchor-link" href="#corepack-use" aria-hidden="true"></a> corepack use</h2>
<p data-line="112" class="code-line">corepack 0.20 以降は <code>corepack use</code> コマンドで package.json への追加ができます。しかもこのコマンドを使うと SHA-256 ハッシュを含むバージョンが指定されます。公式の README では、セキュリティのため、ハッシュはオプションだけど付与することが強く推奨されています。</p>
<p data-line="114" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__fde244915ad3c" src="https://embed.zenn.studio/card#zenn-embedded__fde244915ad3c" data-content="https%3A%2F%2Fgithub.com%2Fnodejs%2Fcorepack%2Fblob%2Fmain%2FREADME.md%23when-authoring-packages" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/nodejs/corepack/blob/main/README.md#when-authoring-packages" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/nodejs/corepack/blob/main/README.md#when-authoring-packages</a></p>
<p data-line="116" class="code-line"><code>corepack use</code> 使用例</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="118">$ corepack use yarn@1.22.19
Installing yarn@1.22.19 <span class="token keyword">in</span> the project<span class="token punctuation">..</span>.

<span class="token function">yarn</span> <span class="token function">install</span> v1.22.19
</code></pre></div><p data-line="125" class="code-line">追加されるバージョン</p>
<div class="code-block-container"><pre class="language-json"><code class="language-json code-line" data-line="127"><span class="token punctuation">{</span>
  <span class="token property">"packageManager"</span><span class="token operator">:</span> <span class="token string">"yarn@1.22.19+sha256.732620bac8b1690d507274f025f3c6cfdc3627a84d9642e38a07452cc00e0f2e"</span>
<span class="token punctuation">}</span>
</code></pre></div><h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="133" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p data-line="135" class="code-line">Node.js にバンドルされていてすぐに使えますし、既に当たり前に使っている人は多そうですが、yarn や pnpm の管理がシュッとできて便利なので、2024年こそ corepack 使っていきましょう！</p>
<p data-line="137" class="code-line">昨日までの私のように、まだ corepack を意識して使っていなくて、そろそろ使った方が良いのかなーどうなのかなーとちょっと迷っている方の参考になれば幸いです。</p>
<p data-line="139" class="code-line">それでは！</p>


【非推奨】2024年こそ corepack を使おう

yarn を使っているプロジェクトで検証

pnpm を使っているプロジェクトで検証

Discussion