【Docker】Git Bash で Docker を実行するときの MSYS_NO_PATHCONV=1 について

Windows の Git Bash から Docker コマンドを実行していると、ボリュームマウントやコンテナ内のパス指定が意図せず Windows パスに変換されることがあります。

たとえば、/app や /var/www/html のようなコンテナ内の Linux パスを指定したつもりでも、Git Bash 側のパス変換によって Docker に渡る引数が変わり、マウントに失敗することがあります。

このような場合は、コマンドの先頭に MSYS_NO_PATHCONV=1 を付けることで回避できます。

MSYS_NO_PATHCONV=1 とは

MSYS_NO_PATHCONV=1 は、Git Bash などの MSYS 系シェルで行われるパス変換を無効化するための環境変数です。

Git Bash は Windows 上で Unix 風の操作感を提供するため、/c/Users/user のようなパスを Windows の C:\Users\user のような形式に変換して、Windows ネイティブの実行ファイルへ渡します。

この変換は便利な一方で、Docker のように「ホスト側のパス」と「コンテナ側の Linux パス」の両方を同じコマンドに書くツールでは、意図しない変換の原因になることがあります。

たとえば、Git Bash で以下のように Docker を実行します。

1
docker run --rm -v "$(pwd)":/app -w /app node:24-alpine npm install

このコマンドでは、以下の 2 種類のパスを使っています。

しかし Git Bash のパス変換が働くと、コンテナ内の /app まで Windows 側のパスとして扱われてしまい、Docker が期待する指定とずれることがあります。

Git Bash から Docker を実行する場合は、以下のようにコマンドの先頭に MSYS_NO_PATHCONV=1 を付けます。

1
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd)":/app -w /app node:24-alpine npm install

これで Git Bash による自動パス変換を抑止し、Docker に指定したパスをそのまま渡せます。

一時的に 1 コマンドだけ無効化したい場合は、この書き方が扱いやすいです。

docker compose コマンドでも同じように指定できます。

1
MSYS_NO_PATHCONV=1 docker compose up -d

docker compose exec でコンテナ内のパスを指定する場合にも有効です。

1
MSYS_NO_PATHCONV=1 docker compose exec app ls /var/www/html

コンテナ内のパスを引数に含めるコマンドで、Git Bash 利用時だけ挙動がおかしい場合は、まず MSYS_NO_PATHCONV=1 を付けて確認すると切り分けしやすいです。

毎回 MSYS_NO_PATHCONV=1 を付けるのが面倒な場合は、Git Bash の設定ファイルに alias を定義しておく方法もあります。

1
2
alias docker='MSYS_NO_PATHCONV=1 docker'
alias docker-compose='MSYS_NO_PATHCONV=1 docker-compose'

~/.bashrc などに追記しておくと、Git Bash を開いたときに自動で反映できます。

ただし、すべての Docker コマンドでパス変換を無効化して問題ないとは限りません。まずは問題が起きるコマンドだけに付けて確認し、必要であれば alias 化するのがおすすめです。

MSYS_NO_PATHCONV=1 は MSYS 系シェルのパス変換を抑止するための指定です。

そのため、PowerShell やコマンドプロンプト、WSL の bash から Docker を実行している場合は、基本的にこの指定は不要です。

環境ごとの使い分けとしては、以下のように考えると分かりやすいです。

Git Bash から Docker を実行していて、ボリュームマウントやコンテナ内パスの指定がうまく動かない場合は、Git Bash の自動パス変換が原因になっていることがあります。

その場合は、以下のように MSYS_NO_PATHCONV=1 を付けて実行します。

1
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd)":/app -w /app node:24-alpine npm install

Docker コマンド自体の問題に見えても、実際にはシェルが Docker に渡す前に引数を書き換えているケースがあります。Git Bash + Docker の組み合わせでは、MSYS_NO_PATHCONV=1 を覚えておくとトラブルシュートしやすくなります。