掃二維碼與項(xiàng)目經(jīng)理溝通
我們?cè)谖⑿派?4小時(shí)期待你的聲音
解答本文疑問(wèn)/技術(shù)咨詢(xún)/運(yùn)營(yíng)咨詢(xún)/技術(shù)建議/互聯(lián)網(wǎng)交流
VsCode自從誕生以來(lái),以其各自?xún)?yōu)異的特性迅速走紅。尤其是對(duì)于前端開(kāi)發(fā)小伙伴來(lái)說(shuō),幾乎成為必不可少的開(kāi)發(fā)工具。所以,熟練掌握VsCode的各自使用技巧與調(diào)試技巧會(huì)讓你的日常開(kāi)發(fā)工作效率倍增。

本文將會(huì)以大量圖文的方式,從下面幾個(gè)方面詳細(xì)介紹VsCode的各種技巧:
VsCode安裝后,會(huì)自動(dòng)寫(xiě)入環(huán)境變量,終端輸入code即可喚起VsCode應(yīng)用程序。
在配置文件中添加如下配置,可以增加字符數(shù)標(biāo)尺輔助線。
"editor.rulers": [40, 80, 100]
下面以在VsCode中快速調(diào)試一個(gè)Node項(xiàng)目為例,演示斷點(diǎn)的基本使用。后文會(huì)繼續(xù)結(jié)束各種高級(jí)斷點(diǎn)。
program字段用于指定你的程序入口文件,${workspaceFolder}表示當(dāng)前項(xiàng)目根路徑。
浮窗的操作按鈕功能依次為:
日志斷點(diǎn)是普通斷點(diǎn)的一種變體,區(qū)別在于不會(huì)中斷調(diào)試,而是可以把信息記錄到控制臺(tái)。日志斷點(diǎn)對(duì)于調(diào)試無(wú)法暫停或停止的服務(wù)時(shí)特別有用。步驟如下:
可以使用{}使用變量,比如在此處添加日志斷點(diǎn),b的值為$
條件斷點(diǎn)是表達(dá)式結(jié)果為true時(shí)才會(huì)進(jìn)行斷點(diǎn),步驟如下:
只有該行代碼命中了指定次數(shù),才會(huì)進(jìn)行斷點(diǎn)。步驟如下:
僅當(dāng)執(zhí)行到達(dá)與內(nèi)聯(lián)斷點(diǎn)關(guān)聯(lián)的列時(shí),才會(huì)命中內(nèi)聯(lián)斷點(diǎn)。這在調(diào)試在一行中包含多個(gè)語(yǔ)句的縮小代碼時(shí)特別有用。比如for循環(huán),短路運(yùn)算符等一行代碼包含多個(gè)表達(dá)式時(shí)會(huì)特別有用。步驟如下:
補(bǔ)充知識(shí)點(diǎn):數(shù)據(jù)面板介紹
可以將變量添加到監(jiān)聽(tīng)面板,實(shí)時(shí)觀察變量的變化。
補(bǔ)充知識(shí)點(diǎn):調(diào)試服務(wù)器時(shí)打開(kāi)一個(gè)URI
開(kāi)發(fā) Web 程序通常需要在 Web 瀏覽器中打開(kāi)特定 URL,以便在調(diào)試器中訪問(wèn)服務(wù)器代碼。VS Code 有一個(gè)內(nèi)置功能“ serverReadyAction ”來(lái)自動(dòng)化這個(gè)任務(wù)。
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!');
});{
"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是設(shè)置匹配的程度端口號(hào),端口號(hào)放在小括號(hào)內(nèi),即作為一個(gè)正則的捕獲組使用。uriFormat映射為URI,其中%s使用pattern中的第一個(gè)捕獲組替換。最后使用該URI作為外部程序打開(kāi)的URI。
關(guān)于NodeJs項(xiàng)目的調(diào)試方法,已經(jīng)在上述的斷點(diǎn)的基本使用部分做了介紹,可以網(wǎng)上滾動(dòng)翻閱。
調(diào)試Typescript項(xiàng)目
# 終端運(yùn)行
tsc --init
VS Code 內(nèi)置了對(duì) Ts 調(diào)試的支持。為了支持調(diào)試 Ts 與正在執(zhí)行的 Js 代碼相結(jié)合,VS Code 依賴(lài)于調(diào)試器的source map在 Ts 源代碼和正在運(yùn)行的 Js 之間進(jìn)行映射,所以需要需要開(kāi)啟sourceMap選項(xiàng)。
{
"sourceMap": true,
"outDir": "./out"
}const num: number = 123;
console.log(num);
function fn(arg: string): void {
console.log('fn', arg);
}
fn("Hello");
在上述的ts基本項(xiàng)目中:
注意,如果你使用的是其他終端(比如cmder)的話,有可能會(huì)生成不了,如下圖所示,使用默認(rèn)的powershell即可:
補(bǔ)充知識(shí)點(diǎn):tasks配置文件的創(chuàng)建方式
{
"version": "2.0.0",
"tasks": [
{
"type": "typescript",
"tsconfig": "tsconfig.json",
"problemMatcher": [
"$tsc"
],
"group": "build",
"label": "tsc: 構(gòu)建 - tsconfig.json"
}
]
}
注意,如果編譯后的js文件不在相應(yīng)的位置,通過(guò)圖中的outFiles字段可以指定ts編譯后的js路徑。
修改工作區(qū)ts版本的方法:
學(xué)會(huì)了上述ts的調(diào)試后,我們嘗試調(diào)試html文件,并且html文件中引入ts文件:
Document
Hello
const num: number = 1221;
console.log(num);
function fn(arg: string): void {
console.log('fn', arg);
}
document.body.append('World')
fn("he");
{
// 使用 IntelliSense 了解相關(guān)屬性。
// 懸停以查看現(xiàn)有屬性的描述。
// 欲了解更多信息,請(qǐng)?jiān)L問(wèn): 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: 構(gòu)建 - tsconfig.json",
"webRoot": "${workspaceFolder}"
}
]
}
下面介紹兩種調(diào)試vue2項(xiàng)目的3種方法,其他框架的調(diào)試也類(lèi)似:
不使用vscode插件Debugger for chrome的方法
module.exports = {
configureWebpack: {
// 生成sourceMaps
devtool: "source-map"
}
};
{
"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
}
}
]
}該腳本的作用是運(yùn)行npm run serve編譯命令。
注意:此方式的主要點(diǎn)在于launch.json配置文件中,通過(guò)preLaunchTask字段指定調(diào)試前先運(yùn)行一個(gè)任務(wù)腳本,preLaunchTask的值對(duì)應(yīng)tasks.json文件中的label值。
更多詳細(xì)內(nèi)容,大家可以點(diǎn)擊這里的參考文檔查閱。
借助vscode插件Debugger for Chrome在Chrome中調(diào)試
module.exports = {
configureWebpack: {
// 生成sourceMaps
devtool: "source-map"
}
};
# 終端執(zhí)行命令,啟動(dòng)項(xiàng)目
npm run serve
更多詳細(xì)內(nèi)容,請(qǐng)點(diǎn)擊這里的參考文檔查閱。
借助vscode插件Debugger for Firfox在Firefox中調(diào)試。
{
"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}/" }]
}
]
}
Electron很多人都使用過(guò),主要用于開(kāi)發(fā)跨平臺(tái)的系統(tǒng)桌面應(yīng)用。那么來(lái)看下vue-cli-electron-builder創(chuàng)建的Electron項(xiàng)目怎么調(diào)試。步驟如下:
module.exports = {
configureWebpack: {
devtool: 'source-map'
}
}{
"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"]
}
]
}此處配置了兩個(gè)調(diào)試命令: Electron: Main用于調(diào)試主進(jìn)程,Electron: Renderer用于調(diào)試渲染進(jìn)程;compounds[].選項(xiàng)用于定義復(fù)合調(diào)試選項(xiàng); configurations定義的復(fù)合命令是并行的;
preLaunchTask用于配置命令執(zhí)行前先執(zhí)行的任務(wù)腳本,其值對(duì)應(yīng)tasks.json中的label字段; preLaunchTask用在compounds時(shí),用于定義configurations復(fù)合任務(wù)執(zhí)行前先執(zhí)行的腳本。
{
// 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\\."
}
}
}
]
}在主進(jìn)程相關(guān)代碼上打上斷點(diǎn),然后啟動(dòng)調(diào)試主進(jìn)程命令就可以調(diào)試主進(jìn)程了
注意,這里的options參數(shù)是根據(jù)實(shí)際的情況,自定義添加我們運(yùn)行項(xiàng)目時(shí)所需要的參數(shù),比如我這里因?yàn)閱?dòng)項(xiàng)目的npm命令是:
"serve-local:dev": "cross-env VUE_APP_TYPE=local VUE_APP_ENV=dev vue-cli-service electron:serve"
切換到渲染進(jìn)程的調(diào)試選項(xiàng),在渲染進(jìn)程的代碼處打上斷點(diǎn),點(diǎn)擊調(diào)試。注意,此時(shí)并不會(huì)有斷點(diǎn)終端,需要ctrl+r手動(dòng)刷新軟件進(jìn)程才會(huì)看到渲染進(jìn)程的斷點(diǎn)。
同時(shí)開(kāi)啟渲染進(jìn)程和主進(jìn)程的調(diào)試,只需要切換到調(diào)試全部的選項(xiàng)即可。注意,此種方式因?yàn)閏ompounds[].configurations配置是并行執(zhí)行的,并不一定能保證渲染進(jìn)程調(diào)試一定能附加到主進(jìn)程調(diào)試成功(估計(jì)是時(shí)機(jī)問(wèn)題),有些時(shí)候會(huì)調(diào)試渲染進(jìn)程不成功。所以,可以采取上面的方式進(jìn)行調(diào)試。
更多調(diào)試Electron的內(nèi)容,可以點(diǎn)擊參考文檔查閱。
補(bǔ)充:更進(jìn)一步
從擴(kuò)展商店中安裝snippets
@category:"snippets"
創(chuàng)建全局代碼片段
{
"自動(dòng)補(bǔ)全console.log": {
"scope": "javascript,typescript",
"prefix": "log",
"body": [
"console.log('$1');",
"$2"
],
"description": "輸出console.log('')"
}
}|
關(guān)鍵詞 |
類(lèi)型 |
說(shuō)明 |
|
scope |
? |
代碼片段生效的作用域,可以是多個(gè)語(yǔ)言,比如? |
|
prefix |
`string |
string[]` |
|
body |
? |
代碼片段內(nèi)容,數(shù)組的每一項(xiàng)會(huì)是一行 |
|
description |
? |
? |
|
1?n |
- |
定義光標(biāo)的位置,光標(biāo)根據(jù)數(shù)字大小按tab依次跳轉(zhuǎn);注意? |
"body": [
"console.log('${1:abc}');"
],
用兩個(gè)豎線包含多個(gè)選擇值,|多個(gè)選擇值直接用逗號(hào)隔開(kāi)|
"body": [
"console.log('${1:abc}');",
"${2|aaa,bbb,ccc|}"
],
新建當(dāng)前工作區(qū)的代碼片段
只需要選擇文件 -> 首選項(xiàng) -> 用戶(hù)片段 -> 新建xxx文件夾的代碼片段, 新建后會(huì)在當(dāng)前工作區(qū)生成.vscode/xxx.code-snippets文件
vscode內(nèi)置了對(duì)Emmet的支持,無(wú)需額外擴(kuò)展。例如html的Emmet演示如下:
選中或者光標(biāo)所處的位置,按F2可以對(duì)所有的變量重命名
VsCode擴(kuò)展插件可以做什么事情?
基于Yeoman快速開(kāi)發(fā)VsCode插件,步驟如下:
# 終端運(yùn)行,主要node版本需要12及以上,node10會(huì)安裝報(bào)錯(cuò)
npm i -g yo generator-code

我們?cè)谖⑿派?4小時(shí)期待你的聲音
解答本文疑問(wèn)/技術(shù)咨詢(xún)/運(yùn)營(yíng)咨詢(xún)/技術(shù)建議/互聯(lián)網(wǎng)交流