安装 C#

把 .NET SDK 装到这台电脑上，让简介里的文件真正能运行。安装 SDK，打开新终端，从 dotnet --version 读出一行版本号，创建小文件夹 PineLab，在程序里保留 Console.WriteLine("pine");，再运行 dotnet run，让屏幕显示 pine。命令一旦可用，Windows、macOS 和 Linux 上的结果相同。命令之前的点击步骤因系统而异——先做与眼前这台电脑匹配的那一节，再回到共用的运行步骤。把程序逐行阅读留给下一页。本课是安装与第一次成功运行，不是 ASP.NET 网站。

你在安装什么

下载的是 .NET SDK。SDK 是包含 dotnet 命令的工具包；本课程用它创建项目并运行。只有 runtime 的电脑也许能跑一些应用，但仍然过不了本页，因为 dotnet new 和教学用的 dotnet run 习惯需要 SDK。你不会把 SDK 这几个字母当咒语打进终端。你安装工具包，工具包再带上 dotnet。
从 Microsoft 站点上的官方 .NET 下载页获取工具包（dotnet.microsoft.com）。选择 SDK，不要只选 runtime 包。本课程请用版本 8 或更新。像 8 或 9 这样的长期版本可以。页面若提供更高的当前 SDK 编号也可以。页面同时提供 SDK 时，不要停在仅含 runtime 的安装程序上。点号后面的小数是补丁。一台电脑可能显示 8.0.10，另一台显示 8.0.12。主版本号是 8 或更高时，两者都可用。

Windows

在 Windows 上下载与芯片匹配的 SDK 安装程序（多数 PC 用 x64）。打开安装程序并等它完成。安装程序若显示把 dotnet 加入 PATH 的选项，请保持开启。PATH 是 Windows 在你输入命令时会搜索的文件夹列表。若 SDK 文件夹不在该列表里，即使磁盘上有文件，终端也会说找不到 dotnet。
已经打开的终端看不到 PATH 的变化。关掉安装完成前就开着的所有 Command Prompt 和 PowerShell 窗口。打开一个新窗口。输入 dotnet --version 并按 Enter。屏幕会写出包含 8 或更高主版本号的一行版本。若新窗口仍找不到 dotnet，在 PATH 保持开启且 SDK 安装完成后，再开一个更新的窗口，或重新运行安装程序并保持 PATH 开启。在缺少 dotnet 时不要继续去做 PineLab。

macOS

在 macOS 上下载与芯片匹配的 SDK 安装程序。Apple silicon 的 Mac 使用 arm64 包。较旧的 Intel Mac 使用 x64 包。打开 .pkg 并完成 Install。若 Terminal 已经打开，先退出，再重新打开 Terminal。旧窗口仍可能说找不到命令。
在新的 Terminal 中输入 dotnet --version。屏幕会写出带有 8 或更高主版本号的一行版本。若命令仍缺失，再次完成 .pkg，打开新的 Terminal，再输入一次 dotnet --version。若对话框提供某种类似 Java 的助手，那不是本工具包——关掉它，改用官方下载页上的 .NET SDK 包。

Linux

在 Linux 上按发行版安装其他软件包的方式安装 .NET SDK 包，并使用下载页为你的系统列出的包类型。包安装完成后，打开新终端。输入 dotnet --version。屏幕会写出带有 8 或更高主版本号的一行版本。若终端找不到 dotnet，先完成包安装，打开新窗口，再输入一次版本命令。版本行可用之后，下面共用的项目步骤相同。

创建 PineLab 并运行 pine

版本行不会写出 pine。它只证明 SDK 已安装。pine 来自程序。在新终端中进入你可控制的文件夹，然后创建控制台项目：
dotnet new console -n PineLab -o PineLab --use-program-main
进入文件夹：
cd PineLab
打开 Program.cs，并保持这种教学形状——公开类 Pine、Main，以及一行写出语句：

保存文件。在同一个 PineLab 文件夹里输入：
dotnet run
屏幕显示 pine。一行。没有引号。没有第二行。类名 Pine 不是屏幕上的词。写出行是 Console.WriteLine("pine");，与简介文件同一思路，现在是在真正安装之后执行。
若 dotnet run 找不到项目文件，确认你位于放有 .csproj 文件的 PineLab 内。若屏幕显示的不是 pine，打开 Program.cs，把写出行恢复为引号之间的 "pine"。重新安装 SDK 不能修正错误的文件夹。

安装后的命令习惯

把版本证明和 pine 运行当作两次分开的检查。

安装还不是 First Program

下一页会逐行打开程序，并教你哪一行写出屏幕内容。本页只需要已安装的 SDK，以及一次成功显示 pine 的 dotnet run。不要在这里臆造 ASP.NET 托管。不要跳过 PATH 变化后的新终端规则。当 dotnet new 失败时，不要把仅 runtime 的安装当成完成。
没有 dotnet --version，你就还没证明 SDK。没有显示 pine 的 dotnet run，你就还没完成本页实验。两处检查都要保留。把残留的 Java javac / java Mint 习惯留在这门 C# 安装之外——这里的教学命令是 dotnet。

进入 First Program 之前

你可以安装 .NET SDK 8 或更新版本，打开新终端，读取 dotnet --version，用 dotnet new console ... --use-program-main 创建 PineLab，保留 Console.WriteLine("pine");，再运行 dotnet run 让屏幕显示 pine。表格把版本证明与 pine 运行分开。下一页是 C# First Program。
为清晰的首次运行保留 PineLab 文件夹。练习安装时，把 ASP.NET 模板留在本页之外。把从错误文件夹运行也留在本页之外。这些习惯是进入 First Program 前的检查点。当版本行显示 8 或更高，且 dotnet run 显示 pine 时，安装 C# 就完成了它的工作；若你继续，就已经为 First Program 做好准备。
最后再过一遍：SDK 已安装，已使用新终端，dotnet --version 可读，PineLab 文件夹在，写出行仍是 "pine"，dotnet run 打印 pine，不需要网页主机。每台电脑优先走一条清晰的安装路径，这样每次练习都教同一张从下载到 pine 的地图。