msys2安装与配置: 在windows上使用linux工具链g++和包管理工具pacman C++开发

realysy

已于 2024-10-17 09:14:35 修改

阅读量6.5k

点赞数 3

文章标签： windows linux c++

于 2023-07-17 11:51:32 首次发布

本文链接：https://blog.csdn.net/weixin_44220976/article/details/131761440

版权

文章目录

为什么用这个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参数

整合1：添加到系统右键菜单

新建一个test.reg文件，输入如下内容后双击运行：

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Directory\Background\shell\OpenMsys2Here]
@="open msys2/ucrt64 here"
"Icon"="Y:\\softwares\\msys2\\msys64\\ucrt64.ico"

[HKEY_CLASSES_ROOT\Directory\Background\shell\OpenMsys2Here\command]
@="Y:\\softwares\\msys2\\msys64\\msys2_shell.cmd -defterm -here -no-start -ucrt64"

整合2：在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": 
    {
        "defaults": 
        {
            "opacity": 85  // 半透明
        },
        
        "list": 
        [
            // Powershell and 命令提示符
            // ...
            // msys2 shell
            {
                "commandline": "C:/softwares/msys2/msys64/msys2_shell.cmd -defterm -here -no-start -ucrt64",
                "guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
                "icon": "C:/softwares/msys2/msys64/ucrt64.ico",
                "name": "UCRT64 / MSYS2",
                "startingDirectory": "C:/Users/%USERNAME%"
            },
            {
                "commandline": "C:/softwares/msys2/msys64/msys2_shell.cmd -defterm -here -no-start -msys",
                "guid": "{71160544-14d8-4194-af25-d05feeac7233}",
                "icon": "C:/softwares/msys2/msys64/msys2.ico",
                "name": "MSYS / MSYS2",
                "startingDirectory": "C:/Users/%USERNAME%"
            }
        ]
    },

整合3：在vscode中使用

有两种配置方法，分别将如下内容添加到vscode的settings.json, 注意修改路径为你的安装位置。

一种是path直接指定bash.exe，

教程 https://www.jianshu.com/p/9b14e5f955fd

    "terminal.integrated.profiles.windows": {
        "MSYS2 UCRT": {
            "path": "E:/msys2/msys64/usr/bin/bash.exe",
            "args": [
              "--login",
              "-i"
            ],
            "env": {
              "MSYSTEM": "UCRT64",
              "CHERE_INVOKING": "1"
            }
        }
    },
    "terminal.integrated.defaultProfile.windows": "MSYS2 UCRT",

另一种是官方文档中提到的方法（不推荐） https://www.msys2.org/docs/ides-editors/

但是这样按F5调试时会报错：Unable to start debugging. Unable to establish a connection to GDB. 解决方法是把"terminal.integrated.defaultProfile.windows": "MSYS2 UCRT"注释掉，让VSCode使用默认的cmd或powershell终端
我猜是msys2_shell.cmd通过cmd.exe转接的问题

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