Comment écrire et déboguer des projets .net avec vscode

Installer des plug-ins

Utiliser VSCode pour écrire des projets dotnet core En plus de ses fonctions par défaut, je recommande d'en installer des très uniques. , et Extensions utiles, c'est précisément grâce au mécanisme de plug-in de VSCode qu'il devient plus puissant et répond à nos différents besoins.

1. Extension du langage C#

Ceci est nécessaire pour écrire du code C# à l'aide de VSCode Après l'installation, le débogueur sera automatiquement téléchargé lorsque le fichier .cs est ouvert par défaut.

2. [Commentaire XML C#]

Ce plug-in peut vous aider rapidement à ajouter des commentaires, choisissez de l'installer.

3. [Extensions C#]

Ce plug-in est fortement recommandé et peut vous aider à initialiser le contenu du fichier, y compris l'espace de noms correspondant lors de la création du fichier.

Il existe également d'autres classes auxiliaires, telles que EditorConfig, Guildes, One Dark Theme, Project Manager, Setting Sync, etc.

Créer une nouvelle solution multi-projets

Ouvrez l'outil de ligne de commande et entrez :

$:> dotnet new sln -o vscode_tutorial //在当前目录下 创建名为vscode_tutorial

La commande ci-dessus utilise dotnet sdk , créez un nouveau fichier de solution. Vous pouvez le créer manuellement sans la ligne de commande, mais en utilisant dotnet new, vous pouvez créer plus facilement des projets liés au noyau dotnet, comme le montre la figure suivante :

Après avoir construit la solution, nous devons construire le projet, comprenant un projet de console, un projet de bibliothèque de classes et un projet de test unitaire.

Créez d'abord un projet de bibliothèque de classes publique pour stocker nos méthodes métier (en supposant que nous travaillons sur un projet réel) (notez qu'il a été cd dans le répertoire sln à ce moment)

$:> dotnet new classlib -o VSCodeTutorial.Common //在当前目录下新建类库项目VSCodeTutorial.Common
$:> dotnet sln add VSCodeTutorial.Common/VSCodeTutorial.Common.csproj //将项目添加到解决方案中

De la même manière, nous avons établi le projet console et le projet de test unitaire

$:> dotnet new console -o VSCodeTutorial.ConsoleApp
$:> dotnet sln add VSCodeTutorial.ConsoleApp/VSCodeTutorial.ConsoleApp.csproj
$:> dotnet new xunit -o VSCodeTutorial.UnitTest
$:> dotnet sln add VSCodeTutorail.UnitTest/VSCodeTutorial.UnitTest.csproj

Il convient de noter ici que le nom du modèle de contrôle est console, et pour les tests unitaires nous utilisons xunit.

À ce stade, la structure de notre projet a été établie. Utilisons VsCode pour ouvrir le répertoire actuel et voir la structure du projet terminée, comme indiqué ci-dessous :

Ajouter des dépendances entre les projets

Utilisez VsCode pour ouvrir le fichier de projet VSCodeTutorial.ConsoleApp.csproj et ajoutez une référence au projet commun

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp1.1</TargetFramework>
  </PropertyGroup>
 <!--添加项目引用-->
  <ItemGroup>
    <ProjectReference Include="..\VSCodeTutorial.Common\VSCodeTutorial.Common.csproj" />
  </ItemGroup></Project>

Ouvrez également VSCodeTutorial .UnitTest. csproj, ajoutez une référence au projet commun

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp1.1</TargetFramework>
  </PropertyGroup><!--nuget 上的类库引用-->
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.0.0" />
    <PackageReference Include="xunit" Version="2.2.0" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.2.0" />
  </ItemGroup><!--本地项目引用-->
 <ItemGroup>
    <ProjectReference Include="..\VSCodeTutorial.Common\VSCodeTutorial.Common.csproj" />
  </ItemGroup></Project>

Différent du projet ci-dessus, il y a quelques dépendances supplémentaires ici. Vous pouvez simplement le comprendre ici. Si vous ajoutez les dépendances du package nuget, utilisez simplement. PackageReference comme ci-dessus et remplissez le nom de la bibliothèque de classes et le numéro de version.

Après avoir ajouté les dépendances, nous utilisons dotnet restaurer dans le répertoire racine pour l'initialiser, ou nous pouvons utiliser la commande dotnet build pour essayer de le compiler.

Les dépendances du projet sont présentées dans la figure 2 :

Commencer à écrire du code

Les exigences globales de ce projet : I Vous devez ouvrir un programme console. Lors de l'exécution, l'utilisateur doit saisir un entier inférieur à 50. Après avoir reçu ce nombre, la console calcule la factorielle de ce nombre et affiche le résultat sur la console.

Après une réflexion simple, j'ai décidé de mettre l'implémentation de factorial dans le projet Common et de la tester unitairement. Le code de test a été mis dans le projet UnitTest

Tout d'abord, nous supprimons les fichiers inutiles dans le projet généré précédemment : Class1.cs dans VsCodeTutorial.Common et UnitTest1.cs dans VSCodeTutorial.UnitTest Bien entendu, vous pouvez également les conserver.

Dans la première étape, nous créons un nouveau fichier MathHelper.cs dans le projet VsCodeTutorial.Common et ajoutons le code suivant au fichier pour implémenter notre factorielle. Le code est relativement simple et ne sera pas détaillé.

namespace VSCodeTutorial.Common{    
public class MathHelper
    {        /// <summary>
        /// 阶乘，本例中暂不考虑 溢出的问题哦 Factorial(n) = n*（n-1）*(n-2)...*1;
        /// </summary>
        /// <param name="n">输入参数n</param>
        /// <returns></returns>
        public static int Factorial(int n){            if(n <=0 ){                
throw new System.ArgumentOutOfRangeException("n","参数错误，不能小于等于零");
            }            if(n == 1){                return 1;
            }            return n*Factorial(n-1);
        }
    }
}

La deuxième étape consiste à tester ce code pour voir s'il a atteint notre objectif. Créez un nouveau fichier MathHelpTest.cs dans le projet VSCodeTutorial.UnitTest et ajoutez une méthode pour tester la fonction Factorial au fichier, comme suit Affichage :

using System;
using VSCodeTutorial.Common;
using Xunit;
namespace VSCodeTutorial.UnitTest{    
public class MathHelperTest
    {
         [Fact]        
public void TestFactorial()        {            //先测试一下边界的情况
            int zero = 0 ;            
var exception = Assert.Throws<ArgumentOutOfRangeException>(() => MathHelper.Factorial(zero));            
int one = 1;            
var oneResult = MathHelper.Factorial(one);
            Assert.Equal(1, oneResult);            //再测一下正常的情况
            int five = 5;            
var fiveResult = MathHelper.Factorial(five);
            Assert.Equal(5*4*3*2*1, fiveResult);            
int ten = 10;            
var tenResult = MathHelper.Factorial(ten);
            Assert.Equal(10*9*8*7*6*5*4*3*2*1, tenResult);
        }
    }
}

Utilisez la ligne de commande pour exécuter le test unitaire

Avant de configurer VSCode, je vous recommande tout de même d'utiliser la ligne de commande pour exécuter le test unitaire , ce qui est utile pour une meilleure compréhension du contenu de la configuration.

Entrez la commande dans le répertoire racine : dotnet test ./VSCodeTutorial.UnitTest/VSCodeTutorial.UnitTest.csproj Afficher les résultats en cours d'exécution :

很差劲会出现编码错误，而且这个错误暂时还没有办法解决..但是我猜单元测试通过了，这个问题相信在后续的版本中肯定会得到解决，事实上在Console项目中是可以解决输出乱码问题的。不过可喜的是在VSCode中运行单元测试是没有乱码的问题的。

使用VSCode 运行单元测试

首先当你打开项目的时候，VSCode 可能已经建议你配置一下相关的内容，如下图所示:

选择Yes, 会帮你新建这个一个目录和两个文件，luanch.json是用来执行调试程序的配置，而tasks.json则是配置各种任务的，其中运行单元测试就是一种任务。

首先我们打开tasks.json ，默认已经添加好了一个任务，如下所示：

{    
"version": "0.1.0",    
"command": "dotnet", //全局命令，即所有的任务都使用这个命令，也可以在各个任务中设置    
"isShellCommand": true,    
"args": [],    
"tasks": [        
{            
"taskName": "build", //任务名称 当设置了主的command 之后这个taskName也会作为一个命令参数            
"args": [                
"${workspaceRoot}\\VSCodeTutorial.ConsoleApp\\VSCodeTutorial.ConsoleApp.csproj"
            ],            
"isBuildCommand": true, 
//一个解决方案只能设置一个编译任务，多设置了也是白搭，当然也能执行，只是不能利用快捷方式运行了           
"problemMatcher": "$msCompile"//C#项目的problemMatcher        
}    
]}

默认使用了全局命令行，这样可以在任务中省去配置dotnet命令，但是如果你的解决方案中包括多个项目需要不同的命令行编译方式，如果前端网站使用grunt打包资源，那么顶部应该留空，而在各个子任务中配置command。

还有如果存在多个编译项目时（如客户端和服务端在一个解决方案时），也应该把command配置在子任务中，并设置个性化的taskName以便区别，所以我推荐把command设置在任务中，下面我们修改一下以上代码，并添加一个运行单元测试的人。

{    
"version": "0.1.0",    
"isShellCommand": true,    
"args": [],    
"tasks": [        
{           
"taskName": "build_console",            
"command":"dotnet"
            "args": [                
"build", //组成dotnet build                
//设置需要编译的项目，如果存在多个启动项目可以设置成解决方案文件（.sln）,这里只有一个项目所以设置运行项目也可以                
"${workspaceRoot}\\VSCodeTutorial.ConsoleApp\\VSCodeTutorial.ConsoleApp.csproj"
            ],            
"isBuildCommand": true, //设置是否编译项目            
"problemMatcher": "$msCompile"
        },        
{            
"taskName": "UnitTest",            
"command":"dotnet",            
"args": [                
"test",//组成dotnet test 命令                
"${workspaceRoot}\\VSCodeTutorial.UnitTest\\VSCodeTutorial.UnitTest.csproj"
            ],            
"isTestCommand": true,//设置为单元测试项目           
"problemMatcher": "$msCompile"
        }    
]}

上面的代码中，我将command命令移到了任务中，并给每个任务起了一个好识别的名字，现在这里一个有2个任务了

第一个任务build_console 运行时 会编译VSCodeTutorial.ConsoleApp项目及其依赖的项目

第二个任务UnitTest则是单元测试项目，运行dotnet test命令，这里有个特殊的设置就是"isTestCommand": true 标识为测试项目后可以通过快捷方式运行该命令

任务建好了，我们来运行任务把，windows按下 ctrl+shift+p,在弹出的对话框中输入:task 过滤命令可以得到以下的选项

选择任务:运行测试任务 这条来运行我们之前编写好的单元测试项目，可以看到运行成功的情况，如下图所示：

这里中文显示正常，没有乱码哦，但是我不知道是什么原因..就是这么神奇

对于经常执行的任务，可以通过设置键盘快捷方式来方便调用，可以看到我分别设置了ctrl+shift+t 运行测试任务ctrl+shift+b 运行编译任务，ctrl+shift+r 启动选择任务，大家可以根据自己的喜好来设置。

开始编写控制台代码

打开VSCodeTutorial.ConsoleApp项目中的Program.cs文件，修改其中的代码，如下所示：

using System;
using VSCodeTutorial.Common;
namespace VSCodeTutorial.ConsoleApp{    
class Program
    {        
static void Main(string[] args)        {            
while(true)
            {
                Console.WriteLine("请输入一个小于10的数字,回车结束:");                
string input_str = Console.ReadLine();                
if(int.TryParse(input_str ,out var input_int))
                {                    
if(input_int>0 && input_int<=10){                       
int result =  MathHelper.Factorial(input_int);
                       Console.WriteLine("你输入的数字是{0},它的阶乘结果是{1},退出请按ctrl+c,按其他键再试一次",
input_int,result);
                       Console.ReadKey();
                    }
                }                else{
                    Console.WriteLine("输入的字符不是有效的数字");
                }
            }

        }
    }
}

代码比较 简单，就不做解释了，我们直接来看运行的结果，这里顺便提一下啊，在我们之前做的众多工作之后，我们这里编写代码有美美哒的智能提示哦，如下图所示：

好，再根目录下输入以下命令运行ConsoleApp

$:> dotnet run -p ./VSCodeTutorial.ConsoleApp/VSCodeTutorial.ConsoleApp.csproj

也可以在VSCodeTutorial.ConsoleApp 目录下直接运行dotnet run 命令即可.

结果运行还是乱码中，但是这次我们有办法解决，我们在控制台代码中添加一句代码即可onsole.OutputEncoding = Encoding.UTF8

using System;
using System.Text;
using VSCodeTutorial.Common;namespace VSCodeTutorial.ConsoleApp{    
class Program
    {        
static void Main(string[] args)        {
            Console.OutputEncoding = Encoding.UTF8; // 设置控制台编码
            while(true)
            {
                Console.WriteLine("请输入一个小于10的数字,回车结束:");                
string input_str = Console.ReadLine();                
if(int.TryParse(input_str ,out var input_int))
                {                    
if(input_int>0 && input_int<=10){                       
int result =  MathHelper.Factorial(input_int);
Console.WriteLine("你输入的数字是{0},它的阶乘结果是{1},退出请按ctrl+c,按其他键再试一次",input_int,result);
                       Console.ReadKey();
                    }
                }                else{
                    Console.WriteLine("输入的字符不是有效的数字");
                }
            }

        }
    }
}

使用dotnet build编译后，再次运行Console项目看到了我们期望的界面

程序运行正确，当然了，我们都跑过单元测试了不是。。

开始调试程序

如下图提示操作：

终于轮到我们之前生成的launch.json文件出场了，先来看下它的代码，代码中已经添加了配置的说明

{    
"version": "0.2.0",    
"configurations": [        
{            
"name": ".NET Core Launch (console)", //配置名称 可以改成更好识别的名字            
"type": "coreclr", // .net core类型的调试            
"request": "launch", //调试方式 不用改            
"preLaunchTask": "build", // 前置任务，这里是编译，但是默认的编译任务，已经被我改了名字了，所以这里要改一下哦            "program": "${workspaceRoot}\\VSCodeTutorial.ConsoleApp\\bin\\Debug\\netcoreapp1.1\\VSCodeTutorial.ConsoleApp.dll", //需要调试的DLL的位置 
"args": [], //额外的参数            
"cwd": "${workspaceRoot}\\VSCodeTutorial.ConsoleApp", //工作目录            
"console": "internalConsole", //控制台模式，这里是内嵌控制台，一会要改成外置的，不然没法交互输入            
"stopAtEntry": false,            
"internalConsoleOptions": "openOnSessionStart"
        },        
{            
"name": ".NET Core Attach", //名称            
"type": "coreclr", //类型            
"request": "attach", //使用附加的方式            
"processId": "${command:pickProcess}" //附加的进程ID        
}    
]}

根据实际情况，需要对上面的配置进行以下变更，变更的部分已经添加了注释，附加调试不是本文的重点，就不改了

{    
"version": "0.2.0",    
"configurations": [
        {            
        "name": "调试ConsoleApp", //修改下命令            
        "type": "coreclr",            
        "request": "launch",            
        "preLaunchTask": "build_console", //修改前置任务名和task.json中配置一致            
        "program": "${workspaceRoot}\\VSCodeTutorial.ConsoleApp\\bin\\Debug\\netcoreapp1.1\\
        VSCodeTutorial.ConsoleApp.dll",            
        "args": [],            
        "cwd": "${workspaceRoot}\\VSCodeTutorial.ConsoleApp",            
        "externalConsole":true, //使用外置的控制台            
        "stopAtEntry": false,            
        "internalConsoleOptions": "openOnSessionStart"
        },
        {            
        "name": ".NET Core Attach",            
        "type": "coreclr",            
        "request": "attach",            
        "processId": "${command:pickProcess}"
        }
    ]
}

修改完成后，我们点击运行按钮可以开始调试了，调试的方式和使用VS是一致的，快捷键为F5 F10 F11

完成！

相关文章教程推荐：vscode教程

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!