一、环境准备：安装必要的开发工具
要在VSCode中编译并运行C#文件，首先需要安装以下组件：
.NET SDK：提供编译器（csc）、运行时和项目模板。Visual Studio Code：轻量级编辑器，支持多语言扩展。C# 扩展（由Microsoft官方提供）：增强C#智能提示、调试等功能。
二、验证安装是否成功
在终端执行以下命令确认.NET SDK已正确安装：
dotnet --version
输出类似如下内容表示安装成功：
7.0.100
三、创建一个简单的C#程序
新建一个名为HelloWorld.cs的文件，并输入以下代码：
using System;
class Program
{
static void Main()
{
Console.WriteLine("Hello, World from VSCode!");
}
}
四、使用终端手动编译与运行
打开VSCode内置终端，依次执行以下命令：
csc HelloWorld.cs
./HelloWorld.exe
注意：Windows系统可省略.exe后缀。
五、配置tasks.json实现一键编译
为了提升效率，可通过VSCode的任务系统自动调用csc。步骤如下：
点击菜单栏：Terminal → Configure Task选择：Create tasks.json file from template选择模板：Others
修改生成的tasks.json文件内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "Build C# File",
"command": "csc",
"args": ["${file}"],
"type": "shell",
"group": {
"kind": "build",
"isDefault": true
},
"problemMatcher": ["$msCompile"]
}
]
}
六、配置launch.json实现一键运行
若希望在调试模式下运行程序，需配置launch.json。步骤如下：
点击左侧“运行和调试”图标点击“创建 launch.json 文件”选择环境：.NET Core
修改生成的launch.json文件内容为：
{
"version": "0.2.0",
"configurations": [
{
"name": ".NET Core Launch (console)",
"type": "coreclr",
"request": "launch",
"program": "${workspaceFolder}/bin/Debug/net7.0/${workspaceFolderBasename}.dll",
"args": [],
"stopAtEntry": false,
"serverReadyAction": {
"action": "openExternally"
},
"env": {
"ASPNETCORE_ENVIRONMENT": "Development"
},
"sourceFileMap": {
"/Views": "${workspaceFolder}/Views"
}
}
]
}
七、常见问题分析与解决方案
问题现象可能原因解决方法找不到 csc 命令.NET SDK未安装或未添加到系统路径重新安装.NET SDK，并检查PATH环境变量按下“运行”按钮只编译不执行任务未绑定运行逻辑配置自定义任务或使用终端直接执行无法找到dll文件未先进行编译先执行编译任务再启动调试器
八、进阶技巧：结合脚本自动化流程
可以编写一个批处理脚本或Shell脚本，将编译与运行合并为一个操作。例如，在Linux/macOS中创建run.sh：
#!/bin/bash
filename=$(basename "$1" .cs)
csc "$1"
if [ $? -eq 0 ]; then
./"$filename".exe
fi
然后在tasks.json中调用该脚本：
"command": "./run.sh",
"args": ["${file}"]
九、流程图展示整体工作流
graph TD
A[开始] --> B[编写C#源码]
B --> C{是否配置任务？}
C -->|是| D[执行编译任务]
C -->|否| E[手动编译]
D --> F[运行生成的EXE/DLL]
E --> F
F --> G[结束]