cmd.exeで起動ディレクトリを相対パスで指定する方法徹底解説💻

はじめに (対象読者・この記事でわかること)

この記事は、Windowsのコマンドプロンプト（cmd.exe）を日常的に利用する開発者、システム管理者、またはバッチファイル作成者を対象としています。特に、特定のアプリケーションやスクリプトを「実行したいディレクトリ」を基準にして起動したいが、絶対パスでの指定は環境依存性が高く不便だと感じている方に読んでいただきたいです。

この記事を読むことで、cmd.exeでプログラムを起動する際に、実行ファイル自身の位置を基準とした相対パスで起動ディレクトリを指定する具体的な方法がわかります。結果として、異なる環境でも修正なしに動作する、よりポータブルでメンテナンスしやすいバッチファイルを作成できるようになります。環境に依存しないスクリプトの作成は、開発効率を向上させる上で非常に重要です。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Windowsの基本的なファイル・ディレクトリ操作（エクスプローラーでの移動、パスの概念など） - コマンドプロンプトの基本的なコマンド操作（cd, dir, echo など）

cmd.exeで相対パス指定が求められる背景

cmd.exeでPythonやNode.jsといったインタプリタ系のスクリプトや、特定のアプリケーションを実行する際、そのプログラムがカレントディレクトリ（現在の作業ディレクトリ）に依存するリソース（設定ファイル、ライブラリ、データファイルなど）を参照することがよくあります。例えば、my_script.pyが./config.iniを読み込む場合、my_script.pyが置かれているディレクトリで実行されなければ正しく動作しません。

しかし、cmd.exeの起動オプションでは、直接「このディレクトリをカレントディレクトリとして起動してほしい」という相対パス指定は、残念ながら直感的な方法では提供されていません。例えば、cmd /c "node my_app/index.js"のように記述しても、これはcmd.exeが起動したカレントディレクトリを基準にmy_app/index.jsを探すだけで、my_appディレクトリ自体をカレントディレクトリにしてくれるわけではありません。

この問題を解決するために、cd C:\project\foo && node main.js のように絶対パスでcdコマンドをチェーンさせる方法は有効ですが、C:\project\fooの部分が環境に依存するため、スクリプトのポータビリティが著しく低下します。例えば、GitHubで共有したプロジェクトを別のPCでクローンした場合、パスを毎回修正する必要が出てきます。この課題を解決し、どこに配置しても正しく動作するスクリプトを作成するために、バッチファイルを利用した相対パス指定のテクニックが必要となるのです。

相対パス指定の具体的な方法と実践

ここでは、cmd.exeで相対パスを使って起動ディレクトリを指定する具体的な手順と、その応用方法について詳しく解説します。

基本的な起動コマンドと相対パスの課題

まず、cmd.exeで特定のディレクトリをカレントディレクトリとしてコマンドを実行しようとしたときに直面する問題点を確認しましょう。

例えば、以下のようなディレクトリ構造を持つプロジェクトがあるとします。

C:\Projects\MyProject\
├── run.bat
├── app\
│   └── main.py
└── config\
    └── settings.ini

main.pyはappディレクトリにあり、settings.iniはconfigディレクトリにあります。main.pyが..\config\settings.iniのように相対パスでsettings.iniを参照していると仮定します。このmain.pyをMyProjectディレクトリで起動したい場合、単純にpython app\main.pyと実行すると、MyProjectがカレントディレクトリになるため問題ありません。

しかし、もしmain.pyをappディレクトリ内で実行する必要がある場合（例：main.pyが./data.txtのようなパスを参照している場合）、MyProjectディレクトリからpython app\main.pyと実行しても、カレントディレクトリはMyProjectのままであり、main.py内部での./data.txtの解決はC:\Projects\MyProject\data.txtとなってしまいます。

このため、通常は次のようにcdコマンドを使ってカレントディレクトリを変更してから、目的のコマンドを実行します。

Batch

rem MyProjectディレクトリをカレントディレクトリとして起動したと仮定
cd app
python main.py

この方法は手動で実行する分には問題ありませんが、これをバッチファイルで自動化し、さらにバッチファイル自身の位置を基準とした相対パスで指定したい場合に工夫が必要になります。

バッチファイル（.bat）を利用した解決策

バッチファイルを使うことで、この問題をスマートに解決できます。鍵となるのは、バッチファイル自身のパスを取得する変数%~dp0と、カレントディレクトリを管理するpushd/popdコマンドです。

%~dp0 とは？

%~dp0は、バッチファイルが実行されているドライブ名とパスを返します。末尾には常に\が含まれます。 例えば、C:\Projects\MyProject\run.bat を実行した場合、%~dp0はC:\Projects\MyProject\を返します。

この変数を利用することで、バッチファイル自身がどこに置かれていても、その位置を基準とした相対パスで他のファイルやディレクトリを指定できるようになります。

pushd と popd とは？

• pushd [directory]：現在のカレントディレクトリをメモリに保存（スタックにプッシュ）し、指定されたdirectoryにカレントディレクトリを変更します。指定されたディレクトリが存在しない場合、エラーになります。
• popd：pushdで保存された直前のカレントディレクトリを復元します（スタックからポップ）。

pushdとpopdを組み合わせることで、一時的に作業ディレクトリを変更し、処理が完了したら元のディレクトリに簡単に戻ることができます。これにより、バッチファイルのポータビリティと堅牢性が向上します。

具体的なバッチファイルの例

前述のディレクトリ構造で、MyProjectディレクトリにあるrun.batがappディレクトリをカレントディレクトリとしてmain.pyを実行する例を見てみましょう。

C:\Projects\MyProject\run.bat の内容：

Batch

@echo off
SETLOCAL EnableDelayedExpansion

REM バッチファイル自身のパスを取得し、末尾の'\'を削除してルートパスを定義
SET "BATCH_DIR=%~dp0"
REM 末尾の'\'を取り除くことで、連結時の二重スラッシュを避ける（必須ではないが、より綺麗）
SET "BATCH_DIR=!BATCH_DIR:~0,-1!"

REM 目的のアプリケーションディレクトリを設定
SET "APP_DIR=%BATCH_DIR%\app"

REM appディレクトリにカレントディレクトリを変更し、元のディレクトリを記憶
pushd "%APP_DIR%"

REM ここで目的のコマンドを実行（main.pyが./data.txtなどを参照していても正しく動作する）
echo 現在の作業ディレクトリ: %cd%
python main.py

REM 作業ディレクトリを元に戻す
popd

echo 処理が完了しました。元の作業ディレクトリに戻りました。
pause
ENDLOCAL

解説： 1. @echo off: コマンドの表示をオフにします。 2. SETLOCAL EnableDelayedExpansion: 環境変数の遅延展開を有効にします。これは、ループ内などで変数を設定し、その直後にその変数を使用する場合に必要になります。今回は!BATCH_DIR:~0,-1!のような文字列操作に便利です。 3. SET "BATCH_DIR=%~dp0": バッチファイルが置かれているディレクトリパスをBATCH_DIR変数に格納します。例: C:\Projects\MyProject\ 4. SET "BATCH_DIR=!BATCH_DIR:~0,-1!": ~0,-1は文字列の開始位置0から末尾から1文字目まで（つまり末尾の\を除いた部分）を抽出します。これはパスを連結する際に\\となるのを防ぐための工夫ですが、Windowsのパスは\\を許容するため必須ではありません。ただ、見た目が整います。 5. SET "APP_DIR=%BATCH_DIR%\app": 目的のappディレクトリへのフルパスを構築します。 6. pushd "%APP_DIR%": 現在のカレントディレクトリを記憶し、APP_DIRで指定されたディレクトリ（C:\Projects\MyProject\app）にカレントディレクトリを変更します。パスにスペースが含まれる可能性を考慮し、ダブルクォーテーションで囲むことが重要です。 7. echo 現在の作業ディレクトリ: %cd%: 確認のために現在の作業ディレクトリを表示します。ここでC:\Projects\MyProject\appが表示されるはずです。 8. python main.py: appディレクトリがカレントディレクトリになっているため、main.pyが自身のディレクトリを基準にした相対パスを参照しても正しく動作します。 9. popd: pushdで変更したカレントディレクトリを元の場所（run.batが実行された際のC:\Projects\MyProject\）に戻します。 10. ENDLOCAL: SETLOCALで開始された環境変数の変更を元に戻します。バッチファイル内で設定した変数などがグローバルな環境に影響を与えないようにするために非常に重要です。

このrun.batをどこか別の場所（例: D:\Downloads\MyProject\run.bat）にコピーして実行しても、%~dp0がD:\Downloads\MyProject\を返すため、main.pyは常にD:\Downloads\MyProject\appをカレントディレクトリとして実行されます。これにより、スクリプトのポータビリティが確保されます。

別のバッチファイルを相対パスで呼び出す場合

もしappディレクトリ内に別のバッチファイル（例: app_start.bat）があり、それをrun.batから実行したい場合は、callコマンドを使用します。

C:\Projects\MyProject\app\app_start.bat の内容：

Batch

@echo off
echo app_start.batが実行されました。
echo 現在の作業ディレクトリ（app_start.bat内部）: %cd%

C:\Projects\MyProject\run.bat の内容：

Batch

@echo off
SETLOCAL

SET "BATCH_DIR=%~dp0"
SET "APP_DIR=%BATCH_DIR%app"

pushd "%APP_DIR%"

REM app_start.batを呼び出す
call app_start.bat

popd

ENDLOCAL

callコマンドを使うことで、呼び出し先のバッチファイルが終了した後、呼び出し元のバッチファイルの実行が再開されます。

よくある落とし穴とトラブルシューティング

バッチファイルを扱う上で、いくつかの注意点があります。

• パスにスペースが含まれる場合: ファイルパスやディレクトリ名にスペースが含まれる場合（例: My Project Folder）、必ずダブルクォーテーションで囲む必要があります。上記の例ではpushd "%APP_DIR%"のように囲んでいるため問題ありません。もし囲まないと、スペースで区切られた最初の部分のみがパスとして認識され、エラーになります。

  batch REM 誤った例 (パスにスペースがある場合) pushd C:\Program Files\MyApp REM 正しい例 pushd "C:\Program Files\MyApp"

• %~dp0の末尾の\: %~dp0は必ず末尾に\を含みます。したがって、SET "APP_DIR=%~dp0app"のように連結すると、内部的にはC:\Projects\MyProject\\appのようなパスになります。しかし、Windowsのパスは連続する\を単一の\として解釈するため、これはほとんどの場合問題ありません。前述の例でSET "BATCH_DIR=!BATCH_DIR:~0,-1!"としているのは、見た目をよりきれいに保つための一工夫です。

• 環境変数の永続化: SETコマンドで設定した環境変数は、そのcmd.exeセッション（またはバッチファイル内）でのみ有効です。バッチファイルが終了すると破棄されます。もし永続的に環境変数を設定したい場合は、SETXコマンドを使用する必要がありますが、これは今回のテーマ（一時的なカレントディレクトリ変更）とは異なります。SETLOCALとENDLOCALを使うことで、バッチファイル内での変数変更がグローバルな環境に影響を与えないようにするのがベストプラクティスです。

解決策

バッチファイルと%~dp0、pushd/popdを組み合わせることで、cmd.exeでプログラムを起動する際に、バッチファイル自身の位置を基準とした相対パスで起動ディレクトリを指定することが可能です。これにより、絶対パスの記述による環境依存性を排除し、どのような環境でも意図通りに動作するポータブルなスクリプトを実現できます。この手法は、プロジェクトの配布や、異なる環境での開発・テストにおいて非常に役立ちます。

まとめ

本記事では、cmd.exeでプログラムを起動する際に、起動ディレクトリを相対パスで指定する方法 を解説しました。

• cmd.exe単体では起動時に相対パスでカレントディレクトリを直接指定するのは難しい という背景がありました。絶対パスでの指定は可能ですが、スクリプトのポータビリティが低下します。
• バッチファイル (.batまたは.cmd) を活用することで、この問題を解決できます。特に、バッチファイル自身のパスを取得する変数%~dp0が鍵となります。
• pushdとpopdコマンドを組み合わせることで、一時的に作業ディレクトリを目的の場所に変更し、処理後に元のディレクトリへ安全に戻る ことができます。これにより、プログラムがカレントディレクトリに依存するリソースを正しく参照できるようになります。

この記事を通して、あなたは環境に左右されない、メンテナンスしやすいバッチファイルを作成できるようになるでしょう。プロジェクトを共有したり、異なる環境で作業したりする際に、パスの問題で頭を悩ませることが減るはずです。

今後は、PowerShellにおける同様のテクニックや、より複雑な環境設定をバッチファイルで管理する方法、ログ出力のベストプラクティスなどについても記事にする予定です。

参考資料

• Microsoft Docs: cd (chdir)
• Microsoft Docs: pushd
• Microsoft Docs: popd
• Microsoft Docs: SETLOCAL
• Microsoft Docs: 環境変数