Node.jsでプロジェクトルートのディレクトリを取得する方法
Node.jsでプロジェクトのルートディレクトリを取得する方法はいくつかありますが、一般的な手法を解説いたします。
__dirnameの利用
__dirname は、スクリプトが配置されているディレクトリの絶対パスを返します。
しかし、プロジェクトのルートディレクトリを取得するには、スクリプトの場所によっては適切でない場合があります。
javascriptconsole.log(__dirname);
この方法では、実行するスクリプトのディレクトリが返るため、プロジェクトルートを確実に取得するには、
追加の処理が必要です。
process.cwd()を利用する方法
process.cwd() を使用すると、現在の作業ディレクトリ(カレントワーキングディレクトリ)を取得できます。
通常、プロジェクトのルートで node コマンドを実行するため、こちらの方法が適しています。
javascriptconsole.log(process.cwd());
この方法では、Node.js を実行した場所がルートディレクトリとみなされるため、
一般的なプロジェクト構成では process.cwd() のほうが __dirname より便利です。
import.meta.url を使う方法(ES Module)
ES Module (.mjs ファイルや package.json に "type": "module" を設定した場合) では、 __dirname は利用できません。
そのため、 import.meta.url を利用し、プロジェクトのルートを求める方法があります。
javascriptimport { fileURLToPath } from 'url';
import { dirname } from 'path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
console.log(__dirname);
ただし、これはスクリプトの配置されたディレクトリを取得する方法であり、
プロジェクトルートを求めるには、さらに process.cwd() を利用するほうが適しています。
find-up を利用したルートディレクトリの特定
より確実にプロジェクトのルートを特定したい場合は、 find-up パッケージを使用すると便利です。
例えば、プロジェクトルートには通常 package.json があるため、それを基準に探索できます。
find-up のインストール
shyarn add find-up
find-up を利用したプロジェクトルートの取得
javascriptimport { fileURLToPath } from 'url';
import { dirname } from 'path';
import findUp from 'find-up';
const projectRoot = await findUp('package.json').then(file => file ? dirname(file) : null);
console.log(projectRoot);
この方法では、 package.json を基準にプロジェクトルートを見つけられるため、
より正確にルートディレクトリを取得できます。
まとめ
| 方法 | 特徴 |
|---|---|
__dirname | スクリプトが配置されているディレクトリを取得 |
process.cwd() | Node.js を実行したディレクトリ(一般的にはプロジェクトルート)を取得 |
import.meta.url | ES Module 環境でスクリプトディレクトリを取得 |
find-up | package.json などを基準にプロジェクトルートを検索 |
一般的には process.cwd() を使うのが簡単で便利ですが、
プロジェクトの構成によって find-up を用いるとより確実にルートを特定できます。
適切な方法を選択し、Node.js のプロジェクト管理をより効率的に進めてください。
著書
トラブルシュートNode.jsセキュリティアップデート、今すぐ必要?環境別の判断フローチャート
トラブルシュート【緊急】2026年1月13日発表 Node.js 脆弱性8件の詳細と対策|HTTP/2・async_hooks のDoS問題を解説
トラブルシュートTypeScriptでESMとCJS混在をトラブルシュートする ERR_REQUIRE_ESMとimport不可を直す
チートシートNode.js 25.x, 24.x, 22.x, 20.x の脆弱性対応:2025 年 12 月版で修正された 3 件の High Severity 問題の詳細
使い方Node.js BFF 設計の最適解:Route Handlers/GraphQL/tRPC の責務分割
チートシートNode.js ファイルパス地図:`fs`/`path`/`URL`/`import.meta.url` の迷わない対応表
使い方OpenCode の使い方と料金: ログインなしで、無料のモデルが動いた。Go と Zen の違い
使い方Claude Code が書いた Mermaid の図を表示する方法: ファイルに書かせて、VS Code で開く
挙動Codex の履歴の確認と削除: 消したあとも、頼みごとの文は別のファイルに残っていた
使い方MCP サーバーを入れる前のセキュリティチェック: 何ができるサーバーかは、つなぐ前に見られる
使い方Codex CLI の使い方: 入れてから最初の作業まで。codex exec が止まって見える理由
使い方Orca の使い方: Claude Code のサブスクリプションのまま使える。最初に変える設定は権限
