Win10专业版使用VSCode调试ITensor项目

1. 安装vscode和wsl子系统

访问vscode官网下载最新稳定的windows版本并安装
为vscode安装扩展C/C++和Remote-SSH
在win10专业版中找到启用或关闭windows功能，选择适用于Linux的Windows子系统，根据提示安装后重启系统
在应用商店里面搜索框输入linux，选择匹配的第一个选项点击
在新的页面选择Ubuntu，点击并安装，等待安装完成即可
在开始菜单找到刚才安装好的Ubuntu应用，点击进入会自动配置，等待配置完成即可输入用户名和密码来使用Ubuntu系统
在wsl系统下使用sudo apt-get update && sudo apt-get install make来安装make工具
2. 安装itensor

具体方法见itensor-install/README.md

3. 使用vscode编写代码

3.1 配置vscode

打开vscode，点击左下角的><标志
选择Remote-WSL: New Window，然后在新窗口中进行操作，新窗口的左下角标志为下图原窗口可以根据自己需要决定是否关闭；至于Select Python Interpreter可以点击后选择第一个，或者不管它

3.2 windows的文件与wsl系统的文件互相访问

windows读取wsl系统的文件：
1. 在windows文件管理器进入目录C:\Users\zfb\AppData\Local\Packages\，这里的zfb是用户名，根据每个人的电脑设置不同这个名称也会变化
2. 在文件夹下找到以CanonicalGroupLimited.UbuntuonWindows开头的那个目录，点击进入，并再选择LocalState文件夹进入
3. 在文件夹下右键点击rootfs，选择固定到快速访问，之后便可以在左侧快速访问直接进入这个rootfs文件夹了它里面的目录即为Ubuntu系统的目录，可以直接交互

wsl系统读取windows的文件：打开Ubuntu应用，也就是一个终端窗口，输入命令cd /mnt/c则进入C盘主路径，同理cd /mnt/d进入D盘主路径，可以通过ls命令来验证

3.3 创建新的文件夹

创建一个新的itensor项目通常要新建一个文件夹 第一种方法：在步骤2中打开的窗口里面，点击菜单栏终端-->新建终端，然后在下面的窗口即可使用命令行创建文件夹（与Ubuntu系统的终端功能用法完全一致），若已经有此终端则不需要新建，直接使用即可 第二种方法，不推荐，可能会有问题：在windows资源管理器打开rootfs文件夹，一般再进入home文件夹，zfb文件夹（用户名，根据自己设置的不同而不同）用户名文件夹在当前目录下新建文件夹即可

3.4 正式编写代码

在vscode的菜单栏点击文件-->打开文件夹，在弹出的窗口选择你要打开的文件夹（一般为上一步创建的文件夹），点击确定即可上图中打开的文件夹即为test，在此处右键即可选择新建文件或者文件夹这里以test文件夹为例，需要注意的是Makefile文件来源于github下载的itensor压缩包的tutorial/project_template文件夹下，Makefile文件里面的对应变量需要修改（根据步骤2即可），.cpp文件和.h文件根据自己需要修改为自己的代码 下面是最重要的设置路径和任务环节，配置一次即可以后复制过来永久使用

创建文件夹.vscode，不要忘记前面的.

在.vscode文件夹下为C/C++扩展添加配置文件c_cpp_properties.json，内容如下

{
 "configurations": [
     {
         "name": "Linux",
         "includePath": [
             "${workspaceFolder}/**",
             "/home/zfb/itensor/**"
         ],
         // 修改includePath的第二个值为itensor的安装路径
         // 即options.mk文件所在的目录
         "defines": [],
         "compilerPath": "/usr/bin/gcc",
         "cStandard": "c11",
         "cppStandard": "c++17",
         "intelliSenseMode": "clang-x64"
     }
 ],
 "version": 4
}

在.vscode文件夹下添加配置文件tasks.json，内容如下

{
 "version": "2.0.0",
 "tasks": [
     {
         "label": "itensor-build",
         "command": "make",
         "args": [],
         "type": "shell"
       },
       {
         "label": "itensor-build-debug",
         "command": "make",
         "args": [
           "debug"
         ],
         "type": "shell"
       },
       {
         "label": "itensor-clean",
         "command": "make",
         "args": [
           "clean"
         ],
         "type": "shell"
       }
 ]
}

在.vscode文件夹下添加配置文件launch.json，内容如下

{
 "version": "0.2.0",
 "configurations": [
     {
         "name": "(gdb) Launch",
         "type": "cppdbg",
         "request": "launch",
         "program": "${fileDirname}/${fileBasenameNoExtension}-g",
         "args": [],
         "stopAtEntry": false,
         "cwd": "${fileDirname}",
         "environment": [],
         "externalConsole": false,
         "MIMode": "gdb",
         "miDebuggerPath": "gdb",
         "setupCommands": [
             {
                 "description": "Enable pretty-printing for gdb",
                 "text": "-enable-pretty-printing",
                 "ignoreFailures": false,
             }
         ],
         "preLaunchTask": "itensor-build-debug" 
         // 调试会话开始前执行的任务，与tasks.json的label相对应
     }
 ]
}