快速上手
5 分钟跑通第一个中文 C++ 程序。
第一步：解压，双击「一键安装.cmd」
★ 不再需要你先去装 Visual Studio Build Tools 了（2026-10 起）。
发行包里双击 一键安装.cmd 就会：
- 自动建 9 个别名
- 只给会话级 PATH（不污染你的系统 PATH）
- 检测 VS Build Tools
- 按需下载便携 VS Code（中文界面 + 能认中文关键字的 clangd）
- 跑包内自测
verify.ps1（26 项）
另外还有三个脚本：
| 脚本 | 干什么 |
|---|---|
一键为工作区配置.cmd | 把 .vscode 配到你自己打开的工作区（不用把工作区搬进包里） |
一键装配到我的VSCode.cmd | 用你已有的 VS Code（扩展装进便携 data\，不动 %APPDATA%\Code） |
一键还原我的VSCode.cmd | 完全还原上面那一步 |
★ 包里已经带上了整套「地基」： lib\stl\ 开源 MSVC STL 头、lib\mingw\ 2037 个 mingw-w64 头（public domain）、 lib\compiler\ 11 个手搓的编译器支撑头、bin\ 10 个 VC++ 运行库 DLL —— 所以解压即用，不用先装别的东西。
旧办法：手动装 VS Build Tools（留档）
早期版本要求你先手动装，否则编译会报 找不到文件 'cstdio'：
powershell
winget install --id Microsoft.VisualStudio.2022.BuildTools --override "--quiet --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"装的时候要勾上 「使用 C++ 的桌面开发」 工作负载。
为什么当时要你自己装：C++ 标准库、C 运行库、Windows SDK 都是微软的东西， 我们没有权利打包分发。
二进制兼容这件事没变 —— 因为用的仍是微软原封不动的 MSVC STL， 用本编译器编出来的东西和官方 clang / VS 编出来的完全二进制兼容，可以互相链接。
第二步：下载解压
| 文件 | 大小 |
|---|---|
Chinese++-0.2-win64.zip | 80.8 MB |
下载慢的话见 下载页的说明 —— 国内直连 GitHub 可能较慢。
绿色免安装：解压到任意目录，把那个目录加进 PATH 就能用。
第三步：写第一个程序
新建 示例.cpp：
cpp
#包含 <cstdio> // 中文指令，等价于 #include
#include <vector> // 英文指令 —— 混着写没问题
整数 主函数() { // 主函数 = main
std::vector<int> 数字{1, 2, 3}; // 库名仍是英文
整数 和 = 0; // 整数 = int
对于 (整数 n : 数字) // 对于 = for
和 += n;
std::printf("和 = %d\n", 和);
返回 0; // 返回 = return
}★ 主函数 就是 main —— 同一个标识符，写哪个都行。
编译：
powershell
chinese++ 示例.cpp -o 示例.exe
.\示例.exe输出 和 = 6 就成了。
中英混写是允许的，而且是有意的
上面那段里既有 #包含 也有 #include，既有 整数 也有 std::vector<int> —— 这不是凑合，是设计。
一旦为了「纯」而删掉英文拼写，那不是更强的中文编程，而是更弱的 C++ —— 因为你切断了三十年生态里的一切：第三方库、调试器、现有代码。
所以：能加就不要改。
报错也是中文的
示例.cpp:5:1: error: 未知类型名 '坐标点'; 你是想写 '坐标' 吗?连「你是想写 X 吗」这种提示也是中文的。
但 error: / warning: 这两个级别前缀故意保留英文 —— 编辑器的问题面板和 CI 脚本靠它抓日志，改成中文会把工具链打断。
想切回全英文诊断：
powershell
chinese++ 示例.cpp -o 示例.exe -fno-chinese-diagnostics