VS Code C# 新手快速入门 – wiki基地

作者： /

拥抱代码新旅程：VS Code C# 新手快速入门指南

欢迎来到精彩的编程世界！如果你选择了C#作为你的第一门或新的编程语言，并且希望使用轻量、灵活且功能强大的Visual Studio Code（VS Code）作为你的开发环境，那么你来对地方了。

C#（发音为 “C-Sharp”）是微软开发的一种现代、面向对象的编程语言，广泛应用于各种领域，包括：

  • Web开发： 使用ASP.NET Core构建高性能的网站、Web API和服务。
  • 桌面应用： 构建Windows桌面应用（WPF, Windows Forms）或跨平台的应用（.NET MAUI）。
  • 游戏开发： Unity引擎是使用C#作为主要的脚本语言。
  • 云服务： 利用Azure等云平台开发无服务器功能、微服务等。
  • 移动应用： 使用.NET MAUI或Unity开发跨平台移动应用。
  • 人工智能与机器学习： 通过ML.NET等框架进行数据科学和AI开发。

而VS Code则是一个免费、跨平台、轻量级的源代码编辑器，它通过丰富的扩展插件系统，可以轻松地变身为一个功能齐全的集成开发环境（IDE），特别适合C#的开发入门和日常编码工作。

本篇文章将手把手教你如何从零开始，搭建VS Code下的C#开发环境，编写、运行和调试你的第一个C#程序，让你快速踏上C#编程之旅。

预计耗时： 大约 30-60 分钟（取决于你的网络速度和操作熟练度）。

第一步：准备工作 – 你需要什么？

在开始安装和配置之前，确保你具备以下条件：

  1. 一台电脑： 运行Windows、macOS或Linux操作系统。
  2. 稳定的网络连接： 需要下载安装文件和扩展。
  3. 管理员权限： 安装软件时可能需要。

准备好了吗？我们开始！

第二步：安装 Visual Studio Code

如果你的电脑上还没有安装VS Code，请先进行安装。

  1. 访问官网： 打开你的网络浏览器，访问VS Code官方网站：https://code.visualstudio.com/
  2. 下载安装包： 网站会自动检测你的操作系统，并提供相应的下载按钮（通常是蓝色的大按钮）。点击下载。
  3. 运行安装程序：
    • Windows: 运行下载的 .exe 文件。按照安装向导的提示进行。建议勾选“添加到PATH”（Add to PATH）选项，这样你可以在任何地方通过命令行启动VS Code。其他选项可以根据个人喜好选择，如创建桌面图标、添加到右键菜单等。
    • macOS: 下载 .zip 或 .dmg 文件。如果是 .zip，解压后将 Visual Studio Code.app 拖到“应用程序”文件夹。如果是 .dmg，打开后将图标拖到“应用程序”快捷方式上。
    • Linux: 提供多种安装方式（.deb, .rpm, snap等）。选择适合你Linux发行版的方式进行安装。通常推荐使用包管理器安装，例如在Ubuntu上可以使用 sudo apt update && sudo apt install code。
  4. 完成安装： 启动VS Code。你应该会看到一个欢迎界面。

安装VS Code本身非常简单和快速。

第三步：安装 .NET SDK

C#程序需要在 .NET 运行时环境下执行，并且我们需要 .NET SDK（Software Development Kit，软件开发工具包）来编译、构建和管理C#项目。VS Code 的 C# 开发能力也是构建在 .NET SDK之上的。

  1. 访问 .NET官网： 打开你的网络浏览器，访问 .NET 官方下载页面：https://dotnet.microsoft.com/download
  2. 选择版本和类型：
    • 推荐： 对于新手，通常建议下载最新的 LTS (Long Term Support) 版本或最新的 Standard Term Support (STS) 版本。LTS版本更稳定，支持周期长；STS版本包含最新功能。通常选择推荐的 .NET SDK 版本即可。
    • 在下载页面，找到并点击对应你操作系统的 .NET SDK 下载链接（而不是 .NET Runtime 或 ASP.NET Core Runtime）。
  3. 运行安装程序：
    • Windows: 运行下载的安装包。按照提示进行，接受许可协议，选择安装路径（通常使用默认即可）。确保安装程序显示成功。
    • macOS: 运行下载的 .pkg 文件。按照提示进行。可能需要输入管理员密码。
    • Linux: 访问前面提到的 .NET 下载页面，找到 Linux 部分。它会提供详细的基于不同发行版的安装指南，通常是通过包管理器来安装。按照你使用的Linux发行版的指南进行操作。例如，对于基于Debian的系统（如Ubuntu），通常涉及添加Microsoft包库并使用 apt install dotnet-sdk-x.y 命令。

  4. 验证安装： 安装完成后，打开你的 命令行终端（Windows上是 Command Prompt 或 PowerShell，macOS/Linux上是 Terminal）。输入以下命令并按回车：

    bash
    dotnet --version

    如果安装成功，你应该会看到安装的 .NET SDK 的版本号，例如 7.0.401 或 8.0.100 等。如果提示找不到命令，说明安装或PATH配置有问题，可能需要重启电脑或手动检查安装路径是否在系统的环境变量PATH中（Windows上比较常见）。

第四步：安装 VS Code C# 扩展

这是在 VS Code 中获得良好 C# 开发体验的关键步骤。你需要安装微软官方提供的 C# 扩展。

  1. 打开 VS Code： 启动 Visual Studio Code。
  2. 打开扩展视图： 点击左侧边栏的 Extensions 图标（看起来像四个方块，其中一个飞出去了），或者按下快捷键 Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS)。
  3. 搜索扩展： 在搜索框中输入 C#。
  4. 安装 C# Dev Kit：
    • 微软推荐使用 C# Dev Kit 扩展包，它包含了 IntelliCode（AI辅助编码）、C# 核心扩展以及其他与 .NET 相关的工具。它是提供完整IDE体验的首选。找到 C# Dev Kit 扩展（作者通常显示为 Microsoft），点击 Install 按钮。
    • 注意： C# Dev Kit 需要特定的许可才能用于商业项目。对于学习、个人项目和非商业用途，它是免费的。如果你只进行简单的入门学习或非商业开发，C# Dev Kit 是最佳选择。如果你需要完全免费的解决方案，可以只安装 C# 扩展（由Microsoft提供，它是C# Dev Kit的基础组件），但功能可能不如C# Dev Kit 全面。对于新手，推荐先安装 C# Dev Kit。
  5. 安装相关依赖（如果需要）： C# Dev Kit 安装时可能会提示安装一些相关的依赖，例如 IntelliCode 等。按照提示安装即可。
  6. 重启 VS Code： 安装扩展后，通常需要重启 VS Code 才能使扩展完全生效。关闭并重新打开 VS Code。

现在，你的 VS Code 已经具备了强大的 C# 代码编辑、智能提示、错误检查、格式化、调试等能力。

第五步：VS Code 界面快速导览

在开始写代码之前，让我们快速熟悉一下 VS Code 的关键界面区域，这些区域将伴随你的整个编程过程：

  1. 活动栏 (Activity Bar): 位于最左侧，包含一组图标，用于切换不同的视图（Explorer, Search, Source Control, Run and Debug, Extensions）。
  2. 侧边栏 (Side Bar): 位于活动栏旁边，显示当前选定视图的内容。例如，选择了 Explorer，这里会显示你的文件和文件夹结构。
  3. 编辑器区域 (Editor Area): 位于中间，是你编写和阅读代码的主要区域。可以同时打开多个文件，它们会以标签页的形式显示。
  4. 面板区域 (Panel): 默认在底部，可以通过 Ctrl+ 或 Cmd+ 打开/关闭。包含终端 (Terminal)、输出 (Output)、调试控制台 (Debug Console)、问题 (Problems) 等。对于C#开发，终端和问题面板会经常使用。
  5. 状态栏 (Status Bar): 位于最底部，显示当前文件信息（语言模式、行号、列号）、Git状态、错误/警告数量等。

第六步：创建你的第一个 C# 项目

C# 项目通常使用 .NET CLI (命令行界面) 来创建和管理。我们将使用前面安装的 dotnet 命令来创建一个简单的控制台应用程序。

  1. 打开终端： 在 VS Code 中，打开集成终端。你可以通过菜单 Terminal -> New Terminal，或者使用快捷键 Ctrl+ (Windows/Linux) 或 Cmd+` (macOS)。终端会在 VS Code 底部打开，并且已经定位在你当前打开的文件夹（如果打开了文件夹的话）。
  2. 导航到工作目录： 使用 cd 命令导航到你想创建项目的文件夹。例如：
    • cd Documents/CSharpProjects (如果文件夹不存在，你需要先创建它)

  3. 创建新项目： 在终端中输入以下命令，然后按回车：

    bash
    dotnet new console -o MyFirstCSharpApp

    • dotnet new: 这是创建新项目的命令。
    • console: 指定项目模板为“控制台应用程序”。这是最简单的项目类型，适合入门学习。
    • -o MyFirstCSharpApp: -o 参数指定输出目录的名称。这里我们创建一个名为 MyFirstCSharpApp 的文件夹，并将项目文件放在里面。
    • 打开项目文件夹： 项目创建成功后，终端会显示类似“模板 “Console Application” 已成功创建。”的信息。现在，在 VS Code 中打开刚刚创建的文件夹。
    • 可以通过菜单 File -> Open Folder... (Windows/Linux) 或 File -> Open... (macOS)，然后选择 MyFirstCSharpApp 文件夹。
    • 或者在终端中，确保当前目录是 MyFirstCSharpApp 的父目录，然后输入 code MyFirstCSharpApp 并按回车（这个命令需要你之前安装VS Code时勾选了“添加到PATH”选项）。

打开项目文件夹后，VS Code 的 Explorer 侧边栏会显示项目结构：

  • MyFirstCSharpApp.csproj: 项目文件。这是一个XML文件，包含了项目的配置信息、引用的包等。对于新手，了解它的存在即可，暂时不需要手动编辑。

  • Program.cs: 这是默认的C#源代码文件，是你编写代码的地方。

  • 加载 C# 组件： 当你第一次打开包含 C# 项目的文件夹时，VS Code 右下角可能会弹出一个提示，询问你是否需要加载 C# 组件或构建依赖。请点击确认，这会帮助 VS Code 设置好智能提示和调试等功能。

第七步：编写你的第一个 C# 程序 (“Hello, World!”)

现在，打开 Program.cs 文件。你可能会看到已经有一些默认的代码了：

csharp
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

这是 .NET 6 及更高版本控制台项目的简化模板（称为“顶级语句”）。它非常简洁，直接执行 Console.WriteLine("Hello, World!"); 这行代码。

让我们来修改一下，让它更有“你”的特色：

“`csharp
// See https://aka.ms/new-console-template for more information
// 这是我们的第一个C#程序！

// 使用 Console.WriteLine() 方法在控制台输出一行文本
Console.WriteLine(“你好，C# 世界！”);
Console.WriteLine(“我是 [你的名字]!”); // 把 [你的名字] 替换成你的名字

// 让程序等待用户输入，这样窗口不会立即关闭
Console.WriteLine(“按下任意键退出…”);
Console.ReadKey(); // 读取用户按下的一个键
“`

代码解释：

  • //：这是单行注释的标志。编译器会忽略 // 后面直到行尾的所有内容。
  • Console: 这是 .NET 框架提供的一个类，用于处理控制台输入/输出。
  • .WriteLine(): 这是 Console 类的一个方法（函数）。它接收一个字符串作为参数，并将该字符串输出到控制台，然后在末尾添加一个换行符。
  • .ReadKey(): 这是 Console 类的另一个方法。它会暂停程序的执行，直到用户按下键盘上的一个键。这对于控制台程序很有用，可以防止程序运行结束后窗口立刻消失。
  • "…"：双引号内的文本是字符串字面量，也就是我们要输出的文字。
  • ;：每条语句的末尾都需要加上分号，表示语句的结束。

在 VS Code 中编辑代码时，你会体验到 C# Dev Kit 带来的强大功能：

  • 智能提示 (IntelliSense): 当你输入代码时，VS Code 会弹出建议列表，帮助你快速输入类名、方法名、属性名等，并提供简短的文档说明。
  • 语法高亮: 代码的不同部分会用不同的颜色显示，提高可读性。
  • 错误和警告提示: 如果你的代码有语法错误或潜在问题，VS Code 会在代码下方用红色波浪线（错误）或绿色波浪线（警告）标记出来，并在“问题”面板中列出。
  • 代码格式化: 右键点击编辑器，选择“Format Document” (Shift+Alt+F 或 Shift+Option+F) 可以自动调整代码的缩进和风格，使其更整洁。

修改完代码后，记得保存文件 (Ctrl+S 或 Cmd+S)。

第八步：运行你的程序

有几种方法可以在 VS Code 中运行你的 C# 程序。最基本的是使用 .NET CLI 命令。

  1. 打开终端： 确保你在 VS Code 的集成终端中，并且当前工作目录是你的项目文件夹 (MyFirstCSharpApp)。如果不是，使用 cd MyFirstCSharpApp 进入。

  2. 运行命令： 输入以下命令并按回车：

    bash
    dotnet run

    • dotnet run: 这个命令会先自动编译你的项目，如果编译成功，然后运行编译生成的可执行文件。

如果一切顺利，你应该能在终端中看到程序的输出：

你好，C# 世界！
我是 [你的名字]!
按下任意键退出...

程序会停在这里，等待你按下任意键。按下键盘上的任意一个键后，程序就会结束。

恭喜！你已经成功地编写并运行了你的第一个 C# 程序！

第九步：理解调试 (Debugging)

编程过程中，程序出现错误（Bug）是家常便饭。学会如何调试是成为一名优秀程序员的关键技能。VS Code 提供了强大的调试功能。

什么是调试？

调试是指通过逐步执行程序、检查变量的值、观察程序执行流程来找出并修复错误的过程。

如何在 VS Code 中调试 C# 程序？

  1. 设置断点 (Breakpoints): 断点是你希望程序在执行过程中暂停的位置。在 Program.cs 编辑器中，点击你想要程序暂停的代码行号左侧的空白区域。会出现一个红色圆点，这就是断点。
    例如，在你刚刚写的 Console.WriteLine("你好，C# 世界！"); 这一行左侧点击，设置一个断点。

  2. 启动调试：

    • 点击 VS Code 左侧活动栏的 Run and Debug 图标（一个虫子上面有个播放按钮），或者按下快捷键 Ctrl+Shift+D (Windows/Linux) 或 Cmd+Shift+D (macOS)。
    • 侧边栏会切换到 Run and Debug 视图。通常情况下，C# 扩展会自动检测到你的项目类型并提供调试配置。如果看到绿色的播放按钮旁边显示 “.NET Launch” 或类似的选项，直接点击绿色的播放按钮即可启动调试。
    • 如果提示创建 launch.json 文件： 第一次启动调试，VS Code 可能需要你创建一个 launch.json 文件来配置调试会话。选择 “.NET” 环境，VS Code 会自动生成一个基本的配置。通常默认的配置就可以直接使用。生成后 launch.json 文件会在 .vscode 文件夹里，你可以直接关闭它，不需要修改。然后再点击绿色的播放按钮启动调试。

  3. 调试过程：

    • 程序会开始执行，并在遇到你设置的第一个断点时暂停。被暂停的代码行会高亮显示。
    • 调试控制面板: VS Code 顶部会出现一个小的调试控制面板，包含以下按钮：
      • Continue (F5): 继续执行程序，直到下一个断点或程序结束。
      • Step Over (F10): 执行当前行代码，如果当前行是一个方法调用，则不进入方法内部，而是直接执行完整个方法，然后暂停在下一行。
      • Step Into (F11): 执行当前行代码，如果当前行是一个方法调用，则进入方法内部的第一行代码并暂停。
      • Step Out (Shift+F11): 如果当前在某个方法内部，执行完当前方法的剩余代码，然后暂停在调用该方法的下一行。
      • Restart (Ctrl+Shift+F5 / Cmd+Shift+F5): 停止当前调试会话并重新启动。
      • Stop (Shift+F5): 停止当前调试会话。
    • 变量查看: 在 Run and Debug 侧边栏的顶部，你会看到 “Variables” 面板。它会显示当前程序执行点可见的所有变量及其值。随着你逐步执行代码，变量的值会实时更新。你也可以将鼠标悬停在编辑器中的变量上，会弹出一个小窗口显示其当前值。
    • 观察 (Watch): 在 “Watch” 面板中，你可以手动添加你想持续观察的变量或表达式。
    • 调用堆栈 (Call Stack): 显示程序是如何一步步调用到当前位置的函数/方法的。对于跟踪复杂的程序流程非常有用。
    • 断点 (Breakpoints): 列出你设置的所有断点，你可以在这里启用、禁用或删除断点。
    • 调试控制台 (Debug Console): 在底部的面板区域，你可以切换到 “Debug Console”。这里会显示程序的输出，也可以在这里输入 C# 表达式并查看结果（例如，输入一个变量名看它的值）。

  4. 练习调试：

    • 设置断点在 Console.WriteLine("你好，C# 世界！");
    • 点击 F5 启动调试。程序会在该行暂停。
    • 点击 F10 (Step Over) 执行这一行。在 Debug Console 中你会看到输出。
    • 将断点移动到 Console.ReadKey(); 这一行。
    • 点击 F5 (Continue)。程序会快速执行前两行输出，然后在 Console.ReadKey() 处暂停。
    • 尝试在 Debug Console 中输入 DateTime.Now 并回车，看看输出结果（这是一个C#表达式）。
    • 点击 Stop (Shift+F5) 结束调试。

通过不断设置断点和单步执行，你可以清晰地看到程序的执行流程，以及变量在每一步的变化，这对于定位问题非常有帮助。

第十步：接下来做什么？

恭喜你！你已经成功搭建了VS Code C#开发环境，创建并运行了你的第一个程序，并且了解了基本的调试方法。这仅仅是开始。C# 语言和 .NET 平台非常庞大和强大。你可以继续学习以下内容：

  1. C# 语言基础：

    • 变量、数据类型 (int, string, bool, double 等)
    • 运算符 (算术、比较、逻辑)
    • 控制流 (if/else, switch, for, while 循环)
    • 数组和集合 (List, Dictionary)
    • 方法 (函数) 的定义和调用
    • 面向对象编程 (类、对象、属性、方法、继承、多态、封装)
    • 命名空间 (Namespaces) 和 Using 指令

  2. .NET 框架基础：

    • 了解常用的类和方法 (例如 System 命名空间下的类)
    • 文件输入/输出 (File I/O)
    • 异常处理 (try-catch)

  3. 项目管理：

    • 学习如何使用 dotnet add package 命令添加 NuGet 包（第三方库）。
    • 了解项目文件 (.csproj) 的一些基本概念。

  4. 学习资源：

    • Microsoft Learn (.NET / C#): 官方提供的免费、高质量的学习路径和教程。强烈推荐！ https://learn.microsoft.com/zh-cn/dotnet/csharp/
    • C# 官方文档: 详细的语言规范和库文档。https://learn.microsoft.com/zh-cn/dotnet/csharp/language-reference/
    • 各类在线课程平台： Coursera, Udemy, bilibili 等都有很多C#入门课程。
    • 技术社区： Stack Overflow、SegmentFault、博客园等，遇到问题时搜索或提问。
    • GitHub: 浏览开源C#项目，学习他人的代码。

新手提示与常见问题

  • 保存文件： 记得经常保存你的代码 (Ctrl+S 或 Cmd+S)。
  • 关注“问题”面板： 当你写代码时，VS Code 会实时检查错误和警告，并在底部的“问题”面板中列出。这里是你排查语法错误和潜在问题的重要入口。
  • 阅读错误信息： 初学者常常害怕错误信息，但它们是宝贵的提示。花时间阅读错误信息，理解它在说什么，通常会指向问题的根源。
  • 保持耐心： 学习编程是一个循序渐进的过程，遇到困难是很正常的。不要气馁，坚持练习和探索。
  • 动手实践： 理论知识固然重要，但只有通过大量的动手练习，才能真正掌握编程技能。尝试修改你写的第一个程序，添加新的功能，解决一些小的编程问题。

总结

通过本文的指导，你已经成功在VS Code中搭建了C#开发环境，并迈出了C#编程的第一步。你学会了安装必要的工具，熟悉了VS Code的基本操作，创建、编写、运行和调试了一个简单的C#控制台程序。

这只是冰山一角。C#和.NET的世界充满了可能性。从构建简单的命令行工具到开发复杂的企业级应用程序、游戏或云服务，C#都能胜任。

继续学习，不断实践，保持好奇心。祝你在C#的编程旅程中一切顺利！现在，就开始你的编码冒险吧！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部