2022/02/28(月)MSYS2のセットアップメモ

更新日:
投稿日:

確認環境

msys2-x86_64-20260322

セットアップ

MSYS2から落としてインストールする。

pacman -Syuu

入れとくと便利なものたち

pacman

2023以前の古いMSYS2ではpacman -sS パッケージ名を毎回入れないとインストールできないケースがあるかもしれない。

pacman -S --noconfirm unzip
pacman -S --noconfirm diffutils
pacman -S --noconfirm openssh
pacman -S --noconfirm patch
pacman -S --noconfirm perl
pacman -S --noconfirm zsh
pacman -S --noconfirm git
pacman -Sy --noconfirm openbsd-netcat
# prompt用に退避させる
mv /usr/bin/git /usr/bin/msys2_git

バイナリ追加

dotfileの設定

https://github.com/Lycolia/my-dotfiles

呼び出しを簡略化する

毎回こんな感じで呼ぶのは面倒なので簡略化する。

C:/env/msys64/msys2_shell.cmd -defterm -here -use-full-path -no-start -msys -shell zsh

C:/env/msys64/run_zsh.cmdのようなファイルを作り、以下の内容を書くことでC:/env/msys64/run_zsh.cmd '/c/path/to/hoge.sh'のようにしてシェルスクリプトを実行できるようになる。

@echo off
set MSYSTEM=MSYS
set MSYS2_PATH_TYPE=inherit
set CHERE_INVOKING=1
C:\env\msys64\usr\bin\zsh.exe -l %*

外部連携

呼び出しを簡略化している前提

VSCode連携

{
  "terminal.integrated.defaultProfile.windows": "MSYS2",
  "terminal.integrated.profiles.windows": {
    "MSYS2": {
      "overrideName": true,
      "path": ["C:\\env\\msys64\\run_zsh.cmd"]
    }
  }
}

Windows Terminal連携

{
  "defaultProfile": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
  "profiles": {
    "defaults": {},
    "list": [
      {
        "commandline": "C:/env/msys64/run_zsh.cmd",
        "font": {
          "face": "Consolas",
          "size": 11
        },
        "guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
        "icon": "C:/env/msys64/mingw64.ico",
        "name": "MINGW64 / MSYS2",
        "colorScheme": "VSCode"
      }
    ]
  },
  "schemes": [
    {
      "name": "VSCode",
      "background": "#1e1e1e",
      "foreground": "#d4d4d4",
      "black": "#000000",
      "blue": "#2472c8",
      "brightBlack": "#666666",
      "brightBlue": "#3b8eea",
      "brightCyan": "#29b8db",
      "brightGreen": "#23d18b",
      "brightPurple": "#d670d6",
      "brightRed": "#f14c4c",
      "brightWhite": "#e5e5e5",
      "brightYellow": "#f5f543",
      "cyan": "#11a8cd",
      "green": "#0dbc79",
      "purple": "#bc3fbc",
      "red": "#cd3131",
      "white": "#e5e5e5",
      "yellow": "#e5e510"
    }
  ]
}

msys2_shell.cmdのCLI Optionsの意味合い

msys2_shell.cmdの中身を読んで机上で書いているだけなので実際そう動くのかの検証はしていない。

起動パラメーターについては、:checkparamsラベルの中のループして合致するものがあれば環境変数を立て、既知の環境変数であればmsys2_shiftCounterという変数をインクリメントして、MSYS2用のパラメーターと、ユーザーパラーメーターの教会の切り分けをする実装となっている。これはつまり後続処理でmsys2_shiftCounter個分のパラメーターを読み飛ばし、それ以降のパラメーターを処理するためにある。

-mingw32 | -mingw64 | -ucrt64 | -clang64 | -msys[2]

それぞれで実行環境が変わるが、MSYS2用アプリケーションの開発環境用設定のため、-msysで基本的に問題ない。

内部的には環境変数MSYSTEMに対して、対応する値を設定している。-msys-msys2は等価。

-defterm | -mintty | -conemu

開くターミナルの指定。

  • -defterm
    • 標準ターミナルで開く
    • Windows TerminalやVSCodeで開く場合はこれを指定する
  • -mintty
    • Minttyが起動する
  • -conemu
    • Conemuが起動する

内部的にはシェルを直に蹴るか、minttyやconemuにシェルの起動パラメーターを渡しているかの違いがある。

-here

現在の作業フォルダをカレントディレクトリとして開く。

内部的には環境変数CHERE_INVOKINGに対しenabled_from_argumentsを設定している。

MSYS2公式ではCHERE_INVOKINGには1を設定するそうだが、手元で見た限りenabled_from_argumentsを設定しても動作は変わらなかった。恐らく単純に変数値が設定されているか、そうでないかで処理が分かれていると思われる。

参考までにCHERE_INVOKINGを未設定にするとMSYS2のホーム(~)で起動した。

-where DIRECTORY

指定ディレクトリをカレントディレクトリとして開く。

内部的にはcmdでシェルを起動する前にcdしてるだけ。

-[use-]full-path

Windowsのパスを継承する。

内部的には環境変数MSYS2_PATH_TYPEinheritを設定している。

-no-start

新窓で開かない。

内部的には指定した場合はシェルが直に起動し、指定しない場合startコマンドでシェルが起動するようになっている。

-shell SHELL

ログインシェルを指定する。

例えば-shell zshならzshがログインシェルになる。未指定の場合、bashがログインシェルになる。これはmsys2_shell.cmdでデフォルト値がbashになっているため。

参考までにmsys2_shell.cmdset "LOGINSHELL=bash"を書き換えるとアップデート時に上書きされて消えるので、しないほうがいい。

-help | --help | -? | /?

ヘルプの表示。

内部的にはprinthelpラベルに飛んでいる。

トラブルシューティング

zsh-newuser-install: startup files exist, aborting. Use the argument -f if you want to force the function to be run again.と出る

zsh-newuser-install: startup files exist, aborting.

Use the argument -f if you want to force the function to be run again.>

と出る場合の対処方法。

msys64/usr/share/zsh/scripts/newuserというファイルを消せば出なくなる。