1.14 Windows 环境配置

一、总体思路

原则：够用就好，边用边加。先搭最小可用集，遇到具体需求再扩展。

二、为什么用 scoop

scoop 是 Windows 上的命令行包管理器，功能类似 apt、brew：一条命令装软件、自动加入 PATH、升级时不会在系统里留下散落的安装目录。

它和传统安装包最大的区别是：

三、安装 scoop

在 PowerShell（不是 CMD）中运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

第一行放行本地脚本（scoop 需要），第二行下载并执行安装脚本。安装完成后在 PowerShell 中验证：

scoop --version

常用命令：

Bucket 是什么： scoop 把软件按“源”分组，称为 bucket。默认只有 main（核心工具）；需要更多软件时用 scoop bucket add extras 添加社区维护的 extras 源，scoop bucket add versions 可以装多个版本（如不同版本的 Node.js）。

四、基础工具：Git、Node.js 与 Python

在 PowerShell 中安装：

scoop install git
scoop install nodejs-lts
scoop install python

验证安装：

git --version
node --version
npm --version
python --version

Git 只安装这一次。用户名、邮箱等身份配置，以及日常用法，见 1.15 版本控制与 Git 的「初始配置」一节。

五、C/C++ 工具链（参考 Shenshijun 的指南）

Windows 上 C/C++ 的配置方式，本节直接参考 Shenshijun 的 C/C++ 环境配置指南（仅适用于 Windows，面向算法竞赛 / 练习题场景）。下面是最关键的部分，细节（含截图）以原指南为准。

5.1 安装 MSYS2

前往 MSYS2 官网，根据处理器架构下载安装包：

依次点击“下一步”完成安装，默认路径为 C:\msys64，请记住这个路径。安装完成后打开 MSYS2 MSYS 终端，先更新软件包：

pacman -Syu

5.2 安装 C/C++ 工具链

在 MSYS2 UCRT64 终端（在开始菜单中打开 MSYS2 UCRT64）中执行：

pacman -S --needed --noconfirm mingw-w64-ucrt-x86_64-toolchain mingw-w64-ucrt-x86_64-clang-tools-extra mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-ninja

各包的作用：

验证安装：

clangd --version   # 显示版本即成功
where clangd       # 应显示路径，而不是提示未找到
where g++          # 应显示路径，而不是提示未找到

5.3 配置环境变量

把 C:\msys64\ucrt64\bin 加入系统环境变量 Path（若改了安装路径，请替换为实际路径）：

1. Win + I 打开设置 → 系统 → 系统信息 → 高级系统设置
2. 点击 环境变量 → 在 系统变量 中找到 Path → 编辑 → 新建
3. 粘贴 C:\msys64\ucrt64\bin → 确定 保存
4. 重新打开终端

验证： 在新终端中执行 clangd --version、g++ --version，能显示版本即配置成功。环境变量的原理见 1.2 Windows 设置。

5.4 常见问题预案

六、VS Code 与 C/C++ 插件

6.1 安装 VS Code

用 scoop 安装（extras bucket）：

scoop bucket add extras
scoop install vscode

也可以去 VS Code 官网 下载 System Installer 安装。VS Code 的基础使用见 1.7 文本编辑。

6.2 安装插件

按 Shenshijun 的 C/C++ 指南 安装以下插件：

6.3 配置 clangd 并关闭 IntelliSense

打开任意 .cpp 文件后，clangd 通常会提示与微软 C/C++ 插件的 IntelliSense 冲突，点击 Disable IntelliSense 即可；若误点了，可在 VS Code 设置（JSON）中添加：

"C_Cpp.intelliSenseEngine": "disabled"

6.4 编译运行与调试

• 编译运行： 右上角运行按钮或快捷键 F6（由 C/C++ Compile Run 提供）
• 调试： 先设置断点，再按 F5 启动调试
• 格式化： Shift + Alt + F，首次使用需在弹出的选择框中选 Clang-Format

七、GitHub 与 SSH 密钥

注册 GitHub 账号、生成 SSH 密钥、把公钥添加到 GitHub 并测试连接的完整流程，见 1.16 代码托管平台 的「注册与配置」一节，这里不再重复。环境这边只需记住一点：

八、Docker

容器开发环境见 1.17 Docker 基础。在 Windows / macOS 上安装 Docker Desktop，再打开 WSL 2 后端（若使用 WSL 2，先按 1.14 WSL 环境配置 装好 WSL）。

验证 Docker：

docker --version
docker compose version
docker run --rm hello-world

若 hello-world 无法拉取，先检查网络与镜像源配置。

九、目录总规划

把文件和工具在系统中的位置定下来：

%USERPROFILE%\.ssh\    # SSH 密钥，不整体进入仓库
%USERPROFILE%\scoop\   # scoop 安装的软件，坏了可重装
D:\Projects\           # 项目目录（全英文、无空格，见 1.1 文件管理）
D:\Notes\              # 个人笔记与文档

规划的价值在于“可预期”：新项目放哪、配置文件在哪、不用时清理什么，都有明确答案。

十、换电脑时如何恢复

先记录，再迁移。 换新电脑时：

1. 用 scoop list 记录已安装的软件清单
2. 项目全部推送到远程仓库，新机器 git clone 恢复
3. SSH 密钥不要复制，用 ssh-keygen 生成新密钥并重新注册公钥
4. 配置文件（如 .clang-format、Starship 配置）放入个人配置仓库

# 换新电脑后的示例步骤
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
scoop install git nodejs-lts python
# 按上文第 5、6 节安装 MSYS2 工具链与 VS Code 插件
ssh-keygen -t ed25519 -C "新机器"
git clone git@github.com:你的用户名/dotfiles.git ~/dotfiles

配置迁移完成后，按前文的验证清单逐项执行一遍，新环境就可以接手工作了。

十一、小结

包管理    -> scoop
版本控制  -> Git + GitHub/CNB
语言环境  -> nodejs-lts / python（scoop 管理）
C/C++    -> MSYS2 + clangd
编辑器    -> VS Code + 插件
容器      -> Docker Desktop
SSH 密钥  -> 身份凭证

环境配置的核心不是“一次装对”，而是能够按记录重建并验证。将非敏感配置、版本约束和操作步骤纳入适当的版本控制，能降低迁移与排错成本。

十二、TODO 清单

• 了解 scoop 与手动安装的区别
• 安装 scoop，并用 scoop install 安装 Git、Node.js 与 Python
• 安装 MSYS2 工具链并配置环境变量，clangd --version、g++ --version 验证通过
• 在 VS Code 中配置 clangd 与 C/C++ Compile Run，能编译运行并调试一个 C++ 程序
• 生成 SSH 密钥并添加到 GitHub，ssh -T git@github.com 验证通过
• 尝试用 Docker Desktop 运行一个容器
• 尝试在自己的计算机中配置一套可用的开发环境

十三、值得我们思考的问题