为什么用这个msys2

• 方便windows上的C++开发demo，不需要VS了
• 方便C++开发安装opencv等三方库
• 有了这个就不需要另外安装git, cmake, mingw64了，都可以通过pacman包管理工具一键安装

下载、doc

官网 https://www.msys2.org/
官方文档 https://www.msys2.org/docs/terminals/
github https://github.com/msys2/msys2-installer/releases/

• 根据github readme中的说明，也许自解压包是个更好的选择（更加干净）
  

这个msys2更新还挺活跃的，最新是2023.5.26版本, 软件本体只有84M，nice

安装，很简单

双击安装。安装过程基本上就是在解压，安装过程信息如下：到最后Updating trust database…的时候可能会卡住，此时进度50%，等着，或者尝试翻墙

正在准备安装…

正在准备解压组件......

正在解压组件......
正在提取“20230526msys64.7z”
已完成

正在安装组件 MSYS2
Copying skeleton files.
These files are for the users to personalise their msys2 experience.

They will never be overwritten nor automatically updated.


'./.bashrc' -> '/home/username2/.bashrc'
'./.bash_logout' -> '/home/username2/.bash_logout'
'./.bash_profile' -> '/home/username2/.bash_profile'

'./.profile' -> '/home/username2/.profile'

'C:\windows\system32\drivers\etc\hosts' -> '/etc/hosts'

'C:\windows\system32\drivers\etc\protocol' -> '/etc/protocols'

'C:\windows\system32\drivers\etc\services' -> '/etc/services'

'C:\windows\system32\drivers\etc\networks' -> '/etc/networks'

==> Generating pacman master key. This may take some time.

==> Updating trust database...

==> Appending keys from msys2.gpg...

==> Locally signing trusted keys in keyring...

  -> Locally signed 5 keys.
==> Importing owner trust values...
==> Disabling revoked keys in keyring...

  -> Disabled 4 keys.
==> Updating trust database...

[H[2J[3J
已完成
编写维护工具。

安装已完成!

初次运行，做些配置

安装之后有好几个终端环境，推荐使用的、默认打开的是ucrt64.exe，我这里也用这个，任务栏是这样的：

配置如下（这里刚开始，用Notepad++等编辑器编辑就行）：

• 修改home目录为C:/Users/username这个win目录
  • 配置文件 /etc/nsswitch.conf
  • 修改：db_home: windows cygwin desc
  • 修改后最好把安装位置/home/user/下的配置文件拷贝到win home下，比如.bashrc啥的
  • 修改后重新打开终端生效，可pwd查看路径
• 修改~/.bashrc
  • 使能够记录历史命令
    • 我发现按向上方向键不显示之前输入过的历史命令
    • 向~/.bashrc中添加一行：export PROMPT_COMMAND='history -a'
    • 相同的命令仅记录一次：export HISTCONTROL=ignoredups
  • 使编译的C++程序运行打印中文时不会乱码：
    • 向~/.bashrc中添加一行： chcp.com 65001
• 更换为国内源
  • 配置文件 /etc/pacman.d/下的
  • 修改：
    • db_home: windows cygwin desc各个mirrorlist文件，没必要都修改，修改你需要用的环境即可。比如我用ucrt64则只需修改: mirrorlist.msys, mirrorlist.ucrt64
    • 如何修改：把下面的国内源挪到上面，修改后应该是直接生效的
      
• 关闭不需要的软件源搜索结果：

  • 配置文件 /etc/pacman.conf

  • 修改：翻到最下面，把不需要的环境注释掉：

    # [clangarm64]
    # Include = /etc/pacman.d/mirrorlist.mingw
    # 
    # [mingw32]
    # Include = /etc/pacman.d/mirrorlist.mingw
    # 
    # [mingw64]
    # Include = /etc/pacman.d/mirrorlist.mingw
    
    [ucrt64]
    Include = /etc/pacman.d/mirrorlist.mingw
    
    # [clang32]
    # Include = /etc/pacman.d/mirrorlist.mingw
    # 
    # [clang64]
    # Include = /etc/pacman.d/mirrorlist.mingw
    
    [msys]
    Include = /etc/pacman.d/mirrorlist.msys
    
    

更新

pacman -Syyu，因为已经换源了，速度会挺快
会自动刚更新msys软件本体，和安装过的软件包。如果不想更新某个软件包，可以在配置文件设置。

• 包管理工具是pacman, 也就是arch linux和manjaro linux的包管理工具，所以有问题搜索的时候可以参考这两个发行版的解决方案

软件安装与卸载方法

• 一般的安装命令：pacman -S 软件包名 进行安装
• 卸载命令：pacman -Rs 软件包名
• 如何知道完整包名：pacman -Ss 包名关键词，比如vim
  • pacman -Ss vim 下图就搜索到了两个，前面粉红色的是环境tag，优先安装ucrt64的（尤其是g++，cmake啥的编译工具链最好用ucrt64），但我不想用neovim就选下面的msys那个vim了，红线就是完整包名，安装即可pacman -S vim

安装必要的软件包

• 安装编译工具链：pacman -S mingw-w64-ucrt-x86_64-toolchain

  • 这里面包含很多东西，gcc, g++, make等都有了
  • 关于make命令，官方文档有比较：make vs mingw32-make. 我这里直接链接mingw32-make.exe为make.exe
    • cd /ucrt64/bin
    • ln -s mingw32-make.exe make.exe
    • 我的mingw32-make.exe隶属于mingw-w64-ucrt-x86_64-make软件包，应该就是官方推荐的
      • 可通过pacman -Qo mingw32-make.exe查看

• 安装cmake: pacman -S mingw-w64-ucrt-x86_64-cmake

• 安装git: pacman -S git

  • Git文档：8.1 自定义 Git - 配置 Git
  • 如果你要在vscode中使用Source Control：VSCode msys2/git Source control无法识别git仓库：the folder currently open doesn‘t have a git rep
  • 如果你使用这个git之后检查原有git仓库的status发现中文文件名的文件出错，可修改export LANG="en_US.UTF-8"
  • 防止中文路径被转义：git config --global core.quotepath false
  • git diff时忽略行尾的^M回车符：

    # 忽略行尾的回车
    git config --global core.whitespace cr-at-eol  
    
    # （这两个在msys2/git环境中应该不用执行）
    # 提交时自动转换为换行，检出时保留对应系统的设置
    git config --global core.autocrlf true   # win上设置
    git config --global core.autocrlf input  # unix上设置
    

• 安装其他需要的软件

设置win环境变量

• 上面安装的东西，可执行文件一般在/ucrt64/bin，/usr/bin/下，把这两个加到系统PATH即可（注意顺序），这样你在非msys2终端环境中也能使用这里安装的软件了，比如rm, vim啥的
• 在msys2的终端环境中默认无法使用win环境变量的PATH, 有两种方式可以使用：
  • 方法1：在win环境变量中添加一个新变量MSYS2_PATH_TYPE，值为inherit
  • 方法2：通过安装位置的msys2_shell.cmd启动，并添加-full-path参数

在windows terminal中使用

官方doc https://www.msys2.org/docs/terminals/

修改windows terminal的配置json, 注意修改路径为你的安装位置

// This makes UCRT64 the default shell
"defaultProfile": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
"profiles": {
    
  "list":
  [
    // ...
    {
    
      "guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
      "name": "UCRT64 / MSYS2",
      "commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -ucrt64",
      "startingDirectory": "C:/msys64/home/%USERNAME%",
      "icon": "C:/msys64/ucrt64.ico",
      "font": 
      {
    
        "face": "Lucida Console",
        "size": 9
      }
    },
    {
    
      "guid": "{71160544-14d8-4194-af25-d05feeac7233}",
      "name": "MSYS / MSYS2",
      "commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -msys",
      "startingDirectory": "C:/msys64/home/%USERNAME%",
      "icon": "C:/msys64/msys2.ico",
      "font": 
      {
    
        "face": "Lucida Console",
        "size": 9
      }
    },
    // ...
  ]
}

在vscode中使用

官方文档 https://www.msys2.org/docs/ides-editors/

如下内容添加到vscode的settings.json, 注意修改路径为你的安装位置

{
    
    "terminal.integrated.profiles.windows": {
    
        "MSYS2 UCRT": {
    
            "path": "cmd.exe",
            "args": [
                "/c",
                "C:\\msys64\\msys2_shell.cmd -defterm -here -no-start -ucrt64"
            ]
        }
    },
    "terminal.integrated.defaultProfile.windows": "MSYS2 UCRT"
}