.NET 教程 - Hello World 5 分钟
介绍
目标
安装 .NET 和 Visual Studio Code,并创建第一个应用程序。
先决条件
500 MB 可用硬盘空间。
- 500 MB 可用硬盘空间。
- macOS 12.0 或更高版本。
完成时间
5 分钟 + 下载/安装时间
方案
使用 C# 编写的简单应用程序,将 Hello, World!
打印到 VS Code 控制台。
未准备好安装任何内容?
可以改用我们的 浏览器内教程。
下载并安装
若要生成第一个 .NET 应用程序,需要安装 .NET SDK、Visual Studio Code 和 C# 开发工具包。
.NET SDK (软件开发工具包)是使用 C# 生成和运行应用程序所需的工具和库的免费开源集合。C# 是你将在本教程中使用的面向对象的新式编程语言。
Visual Studio Code (VS Code)是全球最受欢迎的轻型、免费的开源代码编辑器。你将在此处编写 C# 代码。
C# 开发工具包是一组功能强大的 VS Code 扩展,可使 C# 开发更轻松。它可帮助你在生成应用时编写、测试和调试代码。
.NET Winget 配置文件将为你安装 .NET 8 SDK、VS Code 和 C# 开发工具包。如果已安装某些内容,Winget 将跳过该安装步骤。
若要使用 Visual Studio Code 构建你的第一个 .NET 应用程序,请设置环境:
-
下载并安装 .NET SDK:
下载 .NET 8 SDK x64 (Intel)
下载 .NET 8 SDK Arm64 (Apple Silicon)如果使用的是带有 Apple M1 或 M2 芯片的 Mac,则需要安装 Arm64 版本的 SDK。
-
下载和安装 VS Code:
-
打开 VS Code,并在左侧 VS Code 的活动栏中选择“扩展”按钮。在搜索栏中键入 "C#",选择“C# 开发工具包”,然后在 C# 开发工具包扩展页上选择“安装”按钮。
单击下面的链接可下载文件。
打开下载文件夹,然后双击该文件以开始安装。
选择终端或开发人员主页安装说明
双击该文件后,将打开一个终端,你将看到 Winget 配置文件已准备好安装 .NET 8 SDK、VS Code (如果没有)和 C# 开发工具包。
阅读许可协议并同意,方法是在终端中键入“y”,然后按 Enter。
注意: 你有责任了解要选择执行的配置设置。Microsoft 不对你创作或导入的配置文件负责。此配置可能会更改 Windows 中的设置、安装软件、更改软件设置(包括安全设置),并代表你接受第三方程序包和服务的用户协议。运行此配置文件即表示你确认理解并同意这些资源和设置。任何安装的应用程序均由其所有者授权给你。NuGet 既不对第三方程序包或服务负责,也不授予其许可证。
Winget 现在正在安装入门所需的一切内容!完成大约需要 5 分钟,完成后,会在终端中看到下面的输出。
双击该文件后,将打开一个开发人员主页,你将看到 Winget 配置文件已准备好安装 .NET 8 SDK、VS Code (如果没有)和 C# 开发工具包。
阅读许可协议并同意,方法是单击左下角的“我同意并想要继续”,然后单击右下角的“设置为管理员”。在系统询问是否要允许开发人员主页对设备进行更改时,选择“是”。
注意: 你有责任了解要选择执行的配置设置。Microsoft 不对你创作或导入的配置文件负责。此配置可能会更改 Windows 中的设置、安装软件、更改软件设置(包括安全设置),并代表你接受第三方程序包和服务的用户协议。运行此配置文件即表示你确认理解并同意这些资源和设置。任何安装的应用程序均由其所有者授权给你。NuGet 既不对第三方程序包或服务负责,也不授予其许可证。
开发人员主页现在正在安装入门所需的一切内容!完成大约需要 5 分钟,完成后,会在窗口中看到下面的输出。
检查是否已正确安装所有内容
现在已设置环境,请转到 Windows 任务栏中的搜索,然后键入 Visual Studio Code。单击应用程序以打开 VS Code。
设置环境后,打开新的 VS Code 终端。在工具栏中,选择“终端”,然后选择“新终端”。
注意: 请注意,如果通过终端打开 VS Code,则需要启用工作区信任。
现在,通过转到工具栏并选择终端,然后选择新终端来打开新终端。
在终端中,运行以下命令来检查安装。
dotnet
如果安装成功,则应该会看到类似于以下内容的输出:
Usage: dotnet [options]
Usage: dotnet [path-to-application]
Options:
-h|--help Display help.
--info Display .NET information.
--list-sdks Display the installed SDKs.
--list-runtimes Display the installed runtimes.
path-to-application:
The path to an application .dll file to execute.
如果一切正常,请选择下面的 继续 按钮以转到下一步。
遇到错误?
如果收到“未将 "dotnet" 识别为内部或外部命令”错误,请确保已打开新的 VS Code 终端。如果重启 VS Code 或重启计算机没有解决问题,请使用“我遇到了问题”按钮以获取解决问题的帮助。
创建应用
- 按 CTRL+SHIFT+P,在 VS Code 中打开命令面板。
- 按 CMD+SHIFT+P,在 VS Code 中打开命令面板。
- 键入 ".NET: " 来查看可使用 C# 开发工具包运行的命令!
- 查找“.NET: 新建项目”,并将其选中来创建新的 .NET 项目。
- 向下滚动并选择“控制台应用”。
- 选择要保存项目的文件夹位置。
- 出现提示时,在命令面板中将项目命名为
MyConsoleApp
。
选中复选框并选择是,我信任作者以启用工作区信任。
如果你有 Visual Studio 订阅,请登录你的帐户。如果没有看到弹出提示,请单击窗口右下角 VS Code 状态栏中的 C# 图标。
在边栏中,确保 VS Code 资源管理器已打开。此处将显示 MyConsoleApp
文件夹和解决方案资源管理器。按照以下视频进行操作: 折叠 MyConsoleApp
文件夹,打开 解决方案资源管理器,打开 MyConsoleApp
项目,然后将解决方案资源管理器拖放到更高的位置。
- 折叠 VS Code 资源管理器中的
MyConsoleApp
文件夹。 - 单击解决方案资源管理器左侧的 V 形图标可将其展开。
- 单击解决方案资源管理器中
MyConsoleApp
项目的左侧 V 形图标可将其展开。 - 将解决方案资源管理器拖放到 MyConsoleApp 下。
MyConsoleApp
文件夹中的主文件称为 Program.cs
。默认情况下,它已包含将 Hello, World!
写入终端所需的代码。单击文件可查看模板创建的代码:
选择下面的 继续 按钮以转到下一步。
遇到错误?
如果无法解决遇到的问题,请选择下面的“我遇到了问题”按钮,以获取解决问题的帮助。
运行应用
若要运行应用程序,请选择右上角的“运行”按钮右侧的下拉菜单,然后选择“运行与此文件关联的项目”。
应该会在 VS Code 终端中看到 Hello, World!
。
Hello, World!
恭喜你已构建并运行自己第一个 .NET 应用!选择下面的“继续”按钮,转到下一步。
编辑代码
在 Program.cs
文件中,在打印 Hello, World!
的代码后面添加突出显示的行,如下所示:
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");
Console.WriteLine("The current time is " + DateTime.Now);
保存 Program.cs
文件,然后再次选择“运行与文件关联的项目”。如果成功,应会看到类似于以下内容的输出:
Hello, World!
The current time is 2024/11/21 下午12:12:06
后续步骤
恭喜你已生成并运行自己第一个 .NET 应用!
继续学习
若要继续学习一般 .NET 技能,请尝试 Microsoft Learn 上我们的教程,了解 .NET、依赖项、处理文件、调试等方面的信息:
了解 C#
C# 是 .NET 的新式、创新的开放源代码编程语言,可用于构建所有应用程序。首先请尝试 Microsoft Learn 上我们的 C# 交互式教程:
在 Microsoft Learn 上使用 C# 迈出第一步
.NET 初学者
让 Claudia 使用她的初学者视频系列引导你学完 .NET 的基础知识:
你可能还会关注...