[Ringkasan darah muntah] Petua tentang nyahpepijat dan menggunakan VSCode untuk menggandakan kecekapan kerja pembangunan anda

Artikel ini meringkaskan dan berkongsi dengan anda beberapa VSCode teknik penyahpepijatan dan penggunaan lanjutan untuk setiap senario, untuk menggandakan kecekapan kerja pembangunan harian anda, saya harap ia akan membantu semua orang.

VsCode telah menjadi popular dengan cepat dengan ciri-ciri cemerlangnya sejak ia dilahirkan. Terutamanya untuk rakan kongsi pembangunan bahagian hadapan, ia hampir menjadi alat pembangunan yang sangat diperlukan. Oleh itu, menguasai kemahiran penggunaan masing-masing dan kemahiran penyahpepijatan VsCode akan menggandakan kecekapan kerja pembangunan harian anda. Artikel ini akan menggunakan sejumlah besar gambar dan teks untuk memperkenalkan pelbagai teknik VsCode secara terperinci dari aspek berikut:

• Bahagian pertama terutamanya memperkenalkan teknik asas VsCode, seperti pintasan yang biasa digunakan kunci, pembaris bantu, dsb. Mereka yang biasa dengan bahagian ini boleh melangkaunya terus. [Kajian yang disyorkan: "tutorial pengenalan vscode"]
• Bahagian kedua memfokuskan terutamanya pada pelbagai titik putus (seperti titik putus log, titik putus sebaris, titik putus ungkapan, dll.), Panel data, dsb. .
• Bahagian ketiga terutamanya menerangkan penyahpepijatan praktikal pelbagai projek, seperti penyahpepijatan praktikal program Node, program TS, program Vue, program Electron, Html, dll.
• Bahagian terakhir akan menerangkan Petua berguna lain, seperti coretan kod, pemfaktoran semula, Emmet, dsb.

Petua asas

Permulaan pantas

Selepas VsCode dipasang, pembolehubah persekitaran akan ditulis secara automatik , masukkan code dalam terminal untuk menggunakan aplikasi VsCode.

Kekunci pintasan yang biasa digunakan

• ctrl pCari fail dengan cepat dan lompat, tambah : untuk melompat ke baris yang ditentukan

• ctrl shift p Akses semua arahan yang tersedia berdasarkan konteks semasa anda.

• ctrl shift cBuka terminal secara luaran dan navigasi ke laluan projek semasa

• ctrl 按键1左边的符号Tunjukkan panel terminal tersembunyi

• Ctrl B Tukar bar sisi

• Ctrl Pisah penyuntingan fail dengan pantas

• alt 单机左键 Tambah berbilang Letakkan kursor di

• alt shift 单击左键 Tambahkan kursor pada semua kedudukan dalam lajur yang sama

• alt shift 鼠标选择 Pilih kawasan dengan permulaan yang sama dan tamat

• alt 上键或下键 Gerakkan baris semasa atau kawasan yang dipilih ke atas/bawah satu baris

Menegak pembaris

Tambah konfigurasi berikut dalam fail konfigurasi untuk meningkatkan baris bantu pembaris nombor aksara

"editor.rulers": [40, 80, 100]

Kemahiran lanjutan

Asas penggunaan titik putus

Berikut ialah contoh menyahpepijat projek Nod dengan cepat dalam VsCode untuk menunjukkan penggunaan asas titik putus. Artikel berikut akan terus melengkapkan pelbagai titik putus lanjutan.

• Buat projek nod asas untuk Nodejs
• Buka panel nyahpepijat di sebelah kiri, pilih nama projek nod yang ingin anda nyahpepijat dan tambah konfigurasi penyahpepijatan

• Pilih jenis projek penyahpepijatan sebagai Node.js

• Buka yang dijana .vscode/launch. fail json, nyatakan fail kemasukan program

program medan digunakan untuk menentukan fail kemasukan program anda, ${workspaceFolder} mewakili laluan akar projek semasa

• Untuk menambah titik putus dalam program, cuma klik pada bar sisi di sebelah kiri untuk menambah titik putus

• Tekan F5 untuk memulakan Penyahpepijatan, penyahpepijatan yang berjaya akan mempunyai bar operasi tetingkap terapung

Fungsi butang operasi tetingkap terapung ialah:

• Teruskan (F5),
• Nyahpepijat langkah seterusnya (F10),
• Langkah masuk (F11),
• Langkah keluar (Shift F11),
• Nyahpepijat semula (Ctrl Shift F5),
• Tamatkan penyahpepijatan (Shift F5)

Titik putus log

Titik putus log ialah titik putus biasa Varian titik, perbezaannya ialah tidak mengganggu penyahpepijatan , tetapi boleh log maklumat ke konsol. Titik putus log amat berguna apabila menyahpepijat perkhidmatan yang tidak boleh dijeda atau dihentikan. Langkah-langkahnya adalah seperti berikut:

• Langkah untuk menambah titik putus log

• Masukkan maklumat yang anda ingin log titik putus dan klik Enter untuk melengkapkan penambahan

Anda boleh menggunakan {} untuk menggunakan pembolehubah, seperti 在此处添加日志断点，b的值为${b}

• Selepas titik putus log berjaya ditambah, akan ada ikon berlian

• Tekan F5Jalankan untuk melihat hasil penyahpepijatan

Titik putus keadaan ungkapan

Titik putus bersyarat ialah titik putus apabila hasil ungkapan ialah true Langkah-langkahnya adalah seperti berikut:

• Klik kanan pada sebelah kiri baris kod. untuk menambah titik putus. 🎜>

Ikon kecil yang berjaya ditambah adalah seperti berikut

Tekan untuk nyahpepijat dan syaratnya ditetapkan, jadi titik putus ditetapkan

Titik putus kiraan tekan

Titik putus hanya akan dilaksanakan jika baris kod mencecah nombor yang ditentukan kali. Langkah-langkahnya adalah seperti berikut:

• F5Pilih titik putus bersyarat, tukar kepada pilihan bilangan hits, isikan bilangan hits

Isi dengan jayanya seperti berikut Seperti yang ditunjukkan dalam gambar,

Tekan untuk nyahpepijat, seperti yang ditunjukkan dalam gambar, ia akan mengganggu apabila indeks ialah 9

Titik putus sebaris

Titik putus sebaris dipukul hanya apabila pelaksanaan mencapai lajur yang dikaitkan dengan titik putus sebaris . Ini amat berguna apabila menyahpepijat kod terkecil yang mengandungi berbilang pernyataan pada satu baris. Contohnya, untuk gelung, pengendali litar pintas, dsb. amat berguna apabila satu baris kod mengandungi berbilang ungkapan. Langkah-langkahnya adalah seperti berikut:

• F5 Tekan

di lokasi yang ditentukan, jalankan sebaris setiap kali Kod di semua lokasi akan terganggu

• Shift F9

Titik pengetahuan tambahan: Pengenalan kepada panel data

Panel data boleh melihat semua pembolehubah

Klik kanan pada pembolehubah untuk menetapkan nilai pembolehubah, salin nilai pembolehubah dan operasi lain

Apabila memfokus pada panel data, anda boleh mencari dan menapis dengan menaip nilai. Klik butang yang ditunjukkan di bawah untuk mengawal sama ada untuk menapis.

Titik pengetahuan tambahan: Pengenalan kepada panel pemantauan

• Anda boleh menambah pembolehubah pada panel pemantauan dan perhatikan dalam masa nyata perubahan dalam pembolehubah.

Tambah pembolehubah pada panel pemantauan dengan mengklik kanan pada panel pembolehubah dan memilih "Tambah pada Pemantauan"

Anda juga boleh terus Pilih butang Tambah dalam panel pemantauan untuk menambah pembolehubah

Selepas menambah pembolehubah, anda boleh memantau perubahan pembolehubah secara sebenar masa

补充知识点：调试服务器时打开一个URI

开发 Web 程序通常需要在 Web 浏览器中打开特定 URL，以便在调试器中访问服务器代码。VS Code 有一个内置功能“ serverReadyAction ”来自动化这个任务。

• 一段简单的server代码

var express = require('express');
var app = express();

app.get('/', function(req, res) {
  res.send('Hello World!');
});

app.listen(3000, function() {
  console.log('Example app listening on port 3000!');
});

• 配置launch.json，以支持打开URI

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "program": "${workspaceFolder}/app.js",

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "http://localhost:%s",
    "action": "openExternally"
  }
}

pattern是设置匹配的程度端口号，端口号放在小括号内，即作为一个正则的捕获组使用。uriFormat映射为URI，其中%s使用pattern中的第一个捕获组替换。最后使用该URI作为外部程序打开的URI。

• 按F5调试，会自动打开浏览器，且会在下图所示处中断，当继续执行后，浏览器才能看到输出了server的内容



终局：各场景调试实战

调试NodeJS项目

关于NodeJs项目的调试方法，已经在上述的断点的基本使用部分做了介绍，可以网上滚动翻阅。

调试Typescript项目

• 调试TS项目前，先创建一个TS项目

  • 先初始化一个ts程序，生成默认的tsconfig.json文件

  # 终端运行
  tsc --init

  • 打开tsconfig.json文件，开启sourceMap选项和指定编译后输出的路径

  VS Code 内置了对 Ts 调试的支持。为了支持调试 Ts 与正在执行的 Js 代码相结合，VS Code 依赖于调试器的source map在 Ts 源代码和正在运行的 Js 之间进行映射，所以需要需要开启sourceMap选项。

  {
      "sourceMap": true,
      "outDir": "./out"
  }

  • 新建index.ts文件，写一个基本的ts代码

  const num: number = 123;
  console.log(num);
  
  function fn(arg: string): void {
    console.log('fn', arg);
  }
  
  fn("Hello");

• 手动编译调试TS

  在上述的ts基本项目中：

  • 终端执行ts的编译命令tsc

  
  

  • 此时可以看到生成了out文件夹，里面包含一个index.js和一个index.js.map文件

  

  • 在index.ts中随意添加一个断点

  

  • 按F5或者运行 -> 启动调试，此时可以看到可以正常debug调试

  

• 通过构建任务构建调试TS

  • 按Ctrl+Shift+B或选择终端 -> 运行生成任务，此时会弹出一个下拉菜单

  

  • 选择tsc构建选项，此时可以看到自动生成了编译文件

  

  注意，如果你使用的是其他终端(比如cmder)的话，有可能会生成不了，如下图所示，使用默认的powershell即可：

  

  • 调试的话和上述步骤一样，在有了编译后的文件后，按F5即可

• 监视改变并实时编译

  • 按Ctrl + Shift + B选择监视选项，可以实时监视文件内容发生变化，重新编译

  

  • 如下图所示，会实时编译



补充知识点：tasks配置文件的创建方式

• 方法1：点击终端 -> 配置任务 -> 选择任务可以生成对应的tasks.json配置





• 方法2：点击终端 -> 运行生成任务 -> 点击设置图标也可以生成对应的tasks.json配置





补充知识点：每次调试时重新编译

• 按上述的操作已经生成了task.json配置文件

{
	"version": "2.0.0",
	"tasks": [
    {
      "type": "typescript",
      "tsconfig": "tsconfig.json",
      "problemMatcher": [
        "$tsc"
      ],
      "group": "build",
      "label": "tsc: 构建 - tsconfig.json"
    }
  ]
}

• 点击运行 -> 添加配置 -> 选择nodejs



• 在生成的launch.json文件中，添加preLaunchTask字段，值是tasks.json的label值，一定要相同，注意大小写。该字段的作用是在执行命令前先执行改task任务。



注意，如果编译后的js文件不在相应的位置，通过图中的outFiles字段可以指定ts编译后的js路径。

• 在index.ts文件中按F5启动调试，可以看到调试前已经生成了编译文件，而后就可以正常调试了。



补充知识点：VsCode的TS版本说明

• vscode本身内置了对ts的支持

• vscode内置的ts版本（即工作区版本），仅仅用于IntelliSense（代码提示），工作区ts版本与用于编译的ts版本无任何关系。

修改工作区ts版本的方法：

• 在状态栏选择typescript的图标，选择版本切换



• 选择你需要的版本即可





调试html项目

学会了上述ts的调试后，我们尝试调试html文件，并且html文件中引入ts文件:

• 创建html，引入ts编译后的js文件

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <h3>Hello</h3>
  <script src="./out/index.js"></script>
</body>
</html>

• ts源文件如下：

const num: number =  1221;
console.log(num);

function fn(arg: string): void {
  console.log('fn', arg);
}

document.body.append('World')

fn("he");

• 打debug



• launch.json启动命令配置

{
  // 使用 IntelliSense 了解相关属性。 
  // 悬停以查看现有属性的描述。
  // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "pwa-chrome",
      "request": "launch",
      "name": "Launch Chrome",
      "url": "file:///E:/demo/vscode/debug/ts/index.html",
      "preLaunchTask": "tsc: 构建 - tsconfig.json",
      "webRoot": "${workspaceFolder}"
    }
  ]
}

• 选择我们的启动命令



• 按F5可以正常唤起chrome浏览器，并在vscode的ts源码处会有debug效果

调试Vue项目的两种方式

下面介绍两种调试vue2项目的3种方法，其他框架的调试也类似：

不使用vscode插件Debugger for chrome的方法

• 初始化vue项目，配置vue.config.js，指定要生成sourceMaps资源

module.exports = {
  configureWebpack: {
    // 生成sourceMaps
    devtool: "source-map"
  }
};

• 根目录下创建./vscode/launch.json文件 或者选择运行 -> 添加配置 -> Chrome



{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "chrome",
      "request": "launch",
      "name": "vuejs: chrome",
      "url": "http://localhost:8080",
      "webRoot": "${workspaceFolder}",
      "breakOnLoad": true,
      "pathMapping": {
        "/_karma_webpack_": "${workspaceFolder}"
      },
      "sourceMapPathOverrides": {
        "webpack:/*": "${webRoot}/*",
        "/./*": "${webRoot}/*",
        "/src/*": "${webRoot}/*",
        "/*": "*",
        "/./~/*": "${webRoot}/node_modules/*"
      },
      "preLaunchTask": "serve"
    }
  ]
}

• 添加任务脚本

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "serve",
      "type": "npm",
      "script": "serve",
      "isBackground": true,
      "problemMatcher": [
        {
          "base": "$tsc-watch",
          "background": {
            "activeOnStart": true,
            "beginsPattern": "Starting development server",
            "endsPattern": "Compiled successfully"
          }
        }
      ],
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

该脚本的作用是运行npm run serve编译命令。

• 按F5启动调试即可

注意：此方式的主要点在于launch.json配置文件中，通过preLaunchTask字段指定调试前先运行一个任务脚本，preLaunchTask的值对应tasks.json文件中的label值。

更多详细内容，大家可以点击这里的参考文档查阅。

https://github.com/microsoft/vscode-recipes/tree/main/vuejs-cli

借助vscode插件Debugger for Chrome在Chrome中调试

• 第一步还是初始化vue项目，添加vue.config.js文件配置，指定要生成sourceMaps资源

module.exports = {
  configureWebpack: {
    // 生成sourceMaps
    devtool: "source-map"
  }
};

• vscode中扩展中安装Debugger for Chrome插件，并确保没有禁用插件



• 手动启动项目的运行, 此方式不需要配置tasks.json任务

# 终端执行命令，启动项目
npm run serve

• 按F5启动调试即可



更多详细内容，请点击这里的参考文档查阅。

https://vuejs.org/v2/cookbook/debugging-in-vscode.html

借助vscode插件Debugger for Firfox在Firefox中调试

• 和Debugger for Chrome基本一样，区别在于安装Debugger for Firfox插件，并在launch.json配置中，增加调试Firefox的配置即可，配置如下

{
  "version": "0.2.0",
  "configurations": [
    // 省略Chrome的配置...
    // 下面添加的Firefox的配置
    {
      "type": "firefox",
      "request": "launch",
      "reAttach": true,
      "name": "vuejs: firefox",
      "url": "http://localhost:8080",
      "webRoot": "${workspaceFolder}/src",
      "pathMappings": [{ "url": "webpack:///src/", "path": "${webRoot}/" }]
    }
  ]
}

• 调试时选择对应的调试命令即可



Firefox初始启动时不会触发调试，需要刷新一次

调试Electron项目

Electron很多人都使用过，主要用于开发跨平台的系统桌面应用。那么来看下vue-cli-electron-builder创建的Electron项目怎么调试。步骤如下：

• 在初始化项目后，首先修改vue.config.js文件配置，增加sourceMaps配置：

module.exports = {
  configureWebpack: {
    devtool: 'source-map'
  }
}

• 创建调试配置.vscode/launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Electron: Main",
      "type": "node",
      "request": "launch",
      "protocol": "inspector",
      "preLaunchTask": "bootstarp-service",
      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron",
      "windows": {
        "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron.cmd"
      },
      "args": ["--remote-debugging-port=9223", "./dist_electron"],
      "outFiles": ["${workspaceFolder}/dist_electron/**/*.js"]
    },
    {
      "name": "Electron: Renderer",
      "type": "chrome",
      "request": "attach",
      "port": 9223,
      "urlFilter": "http://localhost:*",
      "timeout": 0,
      "webRoot": "${workspaceFolder}/src",
      "sourceMapPathOverrides": {
        "webpack:///./src/*": "${webRoot}/*"
      }
    },
  ],
  "compounds": [
    {
      "name": "Electron: All",
      "configurations": ["Electron: Main", "Electron: Renderer"]
    }
  ]
}

此处配置了两个调试命令: Electron: Main用于调试主进程，Electron: Renderer用于调试渲染进程；compounds[].选项用于定义复合调试选项; configurations定义的复合命令是并行的; preLaunchTask用于配置命令执行前先执行的任务脚本，其值对应tasks.json中的label字段; preLaunchTask用在compounds时，用于定义configurations复合任务执行前先执行的脚本。

• 创建任务脚本

{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "bootstarp-service",
      "type": "process",
      "command": "./node_modules/.bin/vue-cli-service",
      "windows": {
        "command": "./node_modules/.bin/vue-cli-service.cmd",
        "options": {
          "env": {
            "VUE_APP_ENV": "dev",
            "VUE_APP_TYPE": "local"
          }
        }
      },
      "isBackground": true,
      "args": [
        "electron:serve", "--debug"
      ],
      "problemMatcher": {
        "owner": "custom",
        "pattern": {
          "regexp": ""
        },
        "background": {
          "beginsPattern": "Starting development server\\.\\.\\.",
          "endsPattern": "Not launching electron as debug argument was passed\\."
        }
      }
    }
  ]
}

• 启动调试

在主进程相关代码上打上断点，然后启动调试主进程命令就可以调试主进程了



注意，这里的options参数是根据实际的情况，自定义添加我们运行项目时所需要的参数，比如我这里因为启动项目的npm命令是:

"serve-local:dev": "cross-env VUE_APP_TYPE=local VUE_APP_ENV=dev vue-cli-service electron:serve"

• 主进程调试成功



• 开始调试渲染进程

切换到渲染进程的调试选项，在渲染进程的代码处打上断点，点击调试。注意，此时并不会有断点终端，需要ctrl+r手动刷新软件进程才会看到渲染进程的断点。



• 刷新渲染进程后的效果，如下图，已经进入了断点



• 另一种方式

同时开启渲染进程和主进程的调试，只需要切换到调试全部的选项即可。注意，此种方式因为compounds[].configurations配置是并行执行的，并不一定能保证渲染进程调试一定能附加到主进程调试成功（估计是时机问题），有些时候会调试渲染进程不成功。所以，可以采取上面的方式进行调试。



更多调试Electron的内容，可以点击参考文档查阅。
https://nklayman.github.io/vue-cli-plugin-electron-builder/guide/recipes.html#debugging-with-vscode

补充：更进一步：
VS调试React app文档（https://medium.com/@auchenberg/live-edit-and-debug-your-react-apps-directly-from-vs-code-without-leaving-the-editor-3da489ed905f）
VS调试Next.js文档（https://github.com/microsoft/vscode-recipes/tree/main/Next-js）
更多...（https://code.visualstudio.com/docs/nodejs/debugging-recipes）

其他技巧

技巧一：代码片段（snippets）

从扩展商店中安装snippets

@category:"snippets"



创建全局代码片段

• 选择文件 -> 首选项 -> 用户片段
• 选择新建全局代码片段文件



• 添加代码片段文件的文件名称，会生成.code-snippets后缀的文件

• 定义用户片段

{
  "自动补全console.log": {
    "scope": "javascript,typescript",
      "prefix": "log",
      "body": [
        "console.log('$1');",
        "$2"
      ],
    "description": "输出console.log('')"
  }
}

关键词	类型	说明
scope	string	代码片段生效的作用域，可以是多个语言，比如javascript,typescript表示在js和ts生效，不加scope字段表示对所有文件类型生效
prefix	`string	string[]`
body	string[]	代码片段内容，数组的每一项会是一行
description	string	IntelliSense 显示的片段的可选描述
$1 -$n	-	定义光标的位置，光标根据数字大小按tab依次跳转；注意$0是特殊值，表示光标退出的位置，是最后的光标位置。

• 在键盘输入log时效果如下



• 指定光标处的默认值并选中

"body": [
  "console.log('${1:abc}');"
],



• 指定光标处的默认值有多个，并提供下拉选择

用两个竖线包含多个选择值，|多个选择值直接用逗号隔开|

"body": [
  "console.log('${1:abc}');",
  "${2|aaa,bbb,ccc|}"
],



新建当前工作区的代码片段

只需要选择文件 -> 首选项 -> 用户片段 -> 新建xxx文件夹的代码片段, 新建后会在当前工作区生成.vscode/xxx.code-snippets文件



技巧二：Emmet

vscode内置了对Emmet的支持，无需额外扩展。例如html的Emmet演示如下:



技巧三：对光标处代码变量快速重命名

选中或者光标所处的位置，按F2可以对所有的变量重命名



技巧四：代码重构建议

• 选中要重构的代码，点击出现的黄色小灯的图标



• 选中重构的类型



• 输入新的变量名



• 还可以重构到函数



• TS中还可以提取接口等等



补充：VsCode扩展插件开发

VsCode扩展插件可以做什么事情？

• 定制主题、文件图标
• 扩展工作台功能
• 创建webView
• 自定义新的语言提示
• 支持调试特定的runtime

基于Yeoman快速开发VsCode插件，步骤如下:

• 安装Yeoman和用于生成模板的插件VS Code Extension Generator（https://www.npmjs.com/package/generator-code）

# 终端运行，主要node版本需要12及以上，node10会安装报错
npm i -g yo generator-code

• 运行yo code创建命令，选择要生成的项目模板。这里演示New extension



• 根据提示依次选择



• 生成的内容如下



• 按F5生成编译项目，此时会自动打开一个新窗口
• 在新窗口按Ctrl+Shfit+P,输入Hello World命令



• 此时会弹出一个弹窗的效果



• 至此，一个最简单的插件就完成了

更多关于VSCode的相关知识，请访问：vscode教程！！

Atas ialah kandungan terperinci [Ringkasan darah muntah] Petua tentang nyahpepijat dan menggunakan VSCode untuk menggandakan kecekapan kerja pembangunan anda. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!