Skip to content

开发环境配置

MSYS2(Windows必装)

用于在 Windows 下配置 Unix 工具链。

  1. 打开 MSYS2 官网下载 x86_64 版本的 MSYS2 并打开,如msys2-x86_64-20260322.exe

  2. 安装选项保持默认安装。

  3. 在开始菜单里打开 MSYS2 UCRT64 应用。

  4. 配置清华镜像源(加速下载)

    bash
    sed -i "s#https\?://mirror.msys2.org/#https://mirrors.tuna.tsinghua.edu.cn/msys2/#g" /etc/pacman.d/mirrorlist*
  5. 更新包

    bash
    pacman -Syu
  6. 配置环境变量

    在 PowerShell 中运行以下命令。

    powershell
    [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\msys64\ucrt64\bin", "User")
  7. 安装 JetBrians Mono Nerd 字体

    下载 JetBrians Mono Nerd 字体 并安装名为 "JetBrainsMonoNerdFontMono-xxx.ttf" 的 16 个字体。

  8. 在 Windows Terminal 中使用 MSYS2

    打开 Windows Terminal → 标签栏下拉框 → 设置 → 左下角“打开 JSON 文件” → 在list中追加以下内容

    json
    {
       "commandline": "C:\\msys64\\msys2_shell.cmd -defterm -here -no-start -ucrt64",
       "font": 
       {
          "face": "JetBrainsMono Nerd Font Mono"
       },
       "guid": "{fd57d26d-d3d0-448a-8bd5-e44632685d72}",
       "hidden": false,
       "icon": "C:\\msys64\\ucrt64.ico",
       "name": "MSYS2 UCRT64",
       "startingDirectory": "C:\\msys64\\home\\%USERNAME%"
    }

Git

安装

Windows

在 MSYS2 里运行以下命令:

bash
pacman -S mingw-w64-ucrt-x86_64-git
echo -e "@echo off\nsetlocal\nif "%1" equ "rev-parse" goto rev_parse\ngit %*\ngoto :eof\n:rev_parse\nfor /f %%1 in ('git %*') do cygpath -w %%1" > /git-wrap.bat

在 VS Code 中修改 git.pathc:/msys64/git-wrap.bat

Arch Linux

bash
sudo pacman -S git

配置信息

  1. 设置用户名,建议与 GitHub 用户名一致。

    bash
    git config --global user.name "[用户名]"
  2. 设置邮箱,建议与 GitHub 邮箱一致。

    bash
    git config --global user.email "[邮箱]"
  3. 设置默认分支为 main

    bash
    git config --global init.defaultBranch main

C/C++

安装

Windows

在 MSYS2 里运行以下命令:

bash
pacman -S mingw-w64-ucrt-x86_64-gcc

Arch Linux

bash
sudo pacman -S base-devel

与 VS Code 集成

不使用 VS Code 官方 C/C++ 扩展,推荐使用 Clangd(更强的静态分析)。

  1. 安装 VS Code

  2. 安装扩展:clangdCode Runner

  3. 安装 Clangd 本体

    • Windows(MSYS2 中执行)

      bash
      pacman -S mingw-w64-ucrt-x86_64-clang-tools-extra
    • Arch Linux

      bash
      sudo pacman -S clangd
  4. 开启 code-runnerrunInTerminal 设置

  5. 修改 executorMapcpp 配置:

    cd $dir && g++ $fileName -std=c++14 -O2 -o $fileNameWithoutExt && $dir$fileNameWithoutExt
  6. 点击 cpp 文件右上角的 Run Code 按钮运行

检查安装

bash
gcc --version

有输出即为安装成功

Python

使用 uv 作为包管理器(比官方 pip 更快、更易管理)

安装

Windows

提示

如果无法运行 uv,可能需要关闭“Windows 安全中心”中的“应用和浏览器控制”中的“智能应用控制”。

在MSYS2里运行以下命令:

bash
pacman -S mingw-w64-ucrt-x86_64-python mingw-w64-ucrt-x86_64-python-uv

Arch Linux

bash
sudo pacman -S uv

配置 UV 镜像源

警告

Windows 需在 MSYS2 UCRT64 中执行

bash
mkdir -p ~/.config/uv && echo -e '[registries.tuna]\nindex = "https://pypi.tuna.tsinghua.edu.cn/simple/"' > ~/.config/uv/config.toml

与 VS Code 集成

  1. 安装 VS Code

  2. 安装扩展:pythonCode Runner

  3. 开启 code-runnerrunInTerminal 设置

  4. 命令面板 → Python:选择解释器 → 选择 MSYS2 Python

  5. 点击 py 文件右上角的 Run Code 按钮运行

检查安装

bash
python --version
uv --version

有输出即为安装成功

Rust

安装

Windows

在 MSYS2 里运行以下命令:

bash
pacman -S mingw-w64-ucrt-x86_64-rust

Arch Linux

bash
sudo pacman -S rust

配置 Cargo 镜像

警告

Windows 需在 MSYS2 UCRT64 中执行

bash
mkdir -p ~/.cargo && echo -e '[source.crates-io]\nreplace-with = "mirror"\n[source.mirror]\nregistry = "sparse+https://mirrors.aliyun.com/crates.io-index/"' > ~/.cargo/config.toml

检查安装

bash
rustc --version
cargo --version

有输出即为安装成功

与 VS Code 集成

  1. 安装VS Code

  2. 安装扩展:rust-analyzerCode Runner

  3. 开启 code-runnerrunInTerminal 设置

  4. 点击 rs 文件右上角的 Run Code 按钮运行

Node.js

安装

Windows

在 MSYS2 里运行以下命令:

bash
pacman -S mingw-w64-ucrt-x86_64-nodejs
npm install -g pnpm

在 PowerShell 里以管理员身份运行以下命令:

powershell
set-ExecutionPolicy RemoteSigned

Arch Linux

bash
sudo pacman -S nodejs npm pnpm

配置镜像源

bash
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

检查安装

bash
node --version
npm --version
pnpm --version

有输出即为安装成功

Java/Kotlin

Windows 和 Arch Linux 通用。

安装 SDKMAN!

需先安装 Visual C++ Redistributable

bash
pacman -S zip unzip
curl -s "https://get.sdkman.io" | bash
fisher install reitzig/sdkman-for-fish@v2.1.0

检查 SDKMAN! 安装

bash
sdk version

Windows 环境变量

在 PowerShell 中运行以下命令。

powershell
# Java
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Dev\msys64\home\[用户名]\.sdkman\candidates\java\current", "User")
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";%JAVA_HOME%\bin", "User")
[Environment]::SetEnvironmentVariable("CLASSPATH", ".;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar", "User")
# Gralde
[Environment]::SetEnvironmentVariable("GRADLE_HOME", "C:\Dev\msys64\home\[用户名]\.sdkman\candidates\gradle\current", "User")
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";%GRADLE_HOME%\bin", "User")
# Maven
[Environment]::SetEnvironmentVariable("MAVEN_HOME", "C:\Dev\msys64\home\[用户名]\.sdkman\candidates\maven\current", "User")
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";%MAVEN_HOME%\bin", "User")
# Kotlin
[Environment]::SetEnvironmentVariable("KOTLIN_HOME", "C:\Dev\msys64\home\[用户名]\.sdkman\candidates\kotlin\current", "User")
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";%KOTLIN_HOME%\bin", "User")

SDKMAN! 常用命令

查询可用 JDK。

bash
sdk list java

安装特定 JDK 版本(如Zulu 25.0.2)。

bash
sdk install java 25.0.2-zulu

设置默认 JDK 版本。

bash
sdk default java 25.0.2-zulu

切换当前终端的 JDK 版本。

bash
sdk use java 17-tem

安装 Gradle、Maven、Kotlin 等(下载太慢可以直接把文件放进C:\Dev\msys64\home\[用户名]\.sdkman\tmp)。

bash
sdk install gradle 8.14.4
sdk install maven
sdk install kotlin

查看已安装的 SDK。

bash
sdk current

切换 SDK 版本。

bash
sdk use gradle 8.14.4

卸载 SDK。

bash
sdk uninstall java 25.0.2-zulu

升级 SDKMAN!

bash
sdk selfupdate

Released under the GPL v3 License.