首頁 > 開發工具 > VSCode > 主體

手把手帶你了解vscode中的倉庫配置

青灯夜游
發布: 2022-03-25 20:48:57
轉載
4336 人瀏覽過

這篇文章帶大家了解一下vscode中的倉庫配置,希望對大家有幫助!

手把手帶你了解vscode中的倉庫配置

歡迎來到vscode 的世界,開發工具很多,找準自己的需求,才能找到合適的工具,而不是「手上有錘子,看啥都像釘子」;對VSCode 而言,定位在於編輯器而非IDE,IDE 著重開箱即用,因而體積龐大,如Eclipse。

        而編輯器著重對語言和工作流程的豐富支援與自由,因而更為輕量,這意味著它不會針對某個語言或某個方面為使用者做太多事情,但也意味著TA 有很高的自由度,如插件機制、倉庫配置機制等等,本文專注倉庫配置分享,插件機制另起一文。

        那我們就開始拿,衝衝!

手把手帶你了解vscode中的倉庫配置

設定概述

        VS Code 是基於資料夾來管理的,但VS Code 允許你建立幾個跟隨當前資料夾或跟專案相關的配置保存在這個資料夾中,以便團隊內部進行共享。這個資料夾就是.vscode

        這個資料夾中可以包含下列幾個檔案。

手把手帶你了解vscode中的倉庫配置

設定檔(settings.json)

只有目前這個資料夾在 VS Code 中被開啟時才會生效。跟我們說的修改用戶設定是一樣的。

任務設定(tasks.json)

關於VS Code 任務系統的設定檔

偵錯設定(launch.json)

用於說明如何調試目前資料夾下的程式碼

vscode 倉庫設定檔設定檔(settings)

        作為編輯器,自然需要考慮個人偏好設定和多人開發時專案風格統一問題,諸如字體大小、換行符、自動格式化插件配置等等,在VSCode 中對應功能是setting.json配置

配置方式

基礎資訊

**User Settings **:使用者設置,為預設配置,會關聯所有項目,權重低於工作區設定

Workspace Settings:工作區設置,為專案配置,預設沒有,可以自行在專案根路徑下創建,專案路徑/.vscode/settings.json

使用者設定入口:使用UI 設定介面

使用Ctrl ,(mac 是cmd ,) 或點擊左下角齒輪圖示並選擇設置。然後在文字編輯器中找到settings.json

手把手帶你了解vscode中的倉庫配置

#使用者設定入口:使用指令面板

#使用者設定入口:使用指令面板

    使用
  • Ctrl Shift P (mac 是cmd shift P)或點擊左下角齒輪圖標,選擇指令面板。然後輸入settings
  • Open User Settings
會開啟UI 設定介面;
Open Settings (JSON)
會開啟使用者設定settings.json 檔案;

工作區設定入口:.vscode 資料夾

開啟資料夾或工作區

時,手動建立手把手帶你了解vscode中的倉庫配置.vscode

資料夾,並在其中建立
settings.json 檔案。

工作區設定入口:使用指令面板

    #使用
  • Ctrl Shift P(mac 是cmd shift P)或點擊左下角齒輪圖標,選擇指令面板。然後輸入settings
  • Open Workspace Settings
也會開啟UI 設定介面;

Open Workspace Settings (JSON)

會開啟工作區設定settings.json 檔案

設定內容#########關於所有的設定項目可以點此查看###對應文件## #,這裡給出常見設定分享和搜尋相關配置思路。 ###
常見設定:編輯器外觀
  • editor.lineNumbers:編輯器左側是否顯示行號,預設顯示設定即可
  • editor.renderWhitespace: all:以點形式渲染所有空白字元(空格、製表符等)
  • editor.renderIndentGuides:縮排參考線,預設以程式碼區塊連接設定即可
  • editor.rulers: [120]:垂直標尺,會在指定列號處畫上豎線
  • #editor.minimap.enabled: false:是否顯示右側小地圖,個人喜歡關閉
  • editor.cursorBlinking/cursorStyle/cursorWidth:遊標樣式
  • editor.renderLineHighlight: 'all':設定目前行高亮背景,行號也會被高亮
常見設定:書寫體驗

自訂空格符和製表符

{
	editor.detectIndentation: false, // 关闭 VS Code 的自动检测来控制制表符或者空格键的使用
	editor.tabSize: 1, // 制表符对应的空格符长度
	editor.insertSpaces: 1 // 空格符对应空白长度
}
登入後複製

自動儲存

{
	editor.formatOnSave: true
}
登入後複製

新建檔案的預設類型

{
  files.defaultLanguage: 'markdown'
}
登入後複製
搜尋相關設定想法

沒啥,記關鍵字,編輯器相關如下;其他的,emmm,看對應文件

  • editor cursor, 是跟遊標渲染和多遊標相關的設定;
  • editor find, 是與編輯器內搜尋相關的設定;
  • editor font, 是與字體相關的設定;
  • ##editor format,是程式碼格式化;
  • editor suggest, 是和自動補全、建議視窗等相關的設定。
然後在setting UI 面板裡搜尋即可

手把手帶你了解vscode中的倉庫配置

#vscode 倉庫配置之tasks

任務系統的目的,是將各種形形色色的任務腳本盡可能地統一化,然後提供一套簡單但又定制化強的方式操作它們

配置任務

    任務的來源有兩種:對專案的自動偵測以及自訂的task
  • 對專案的自動偵測

VSCode 會自動讀取專案下的設定文件,透過設定檔類型產生手把手帶你了解vscode中的倉庫配置task

假設專案下有package.json
,內容為

{
 "name": "sample",
 "scripts": {
  "test": ""
 }
}
登入後複製

運行時就會發現預設有兩個跟npm 相關的任務:

手把手帶你了解vscode中的倉庫配置

npm install

#npm test

手把手帶你了解vscode中的倉庫配置

自訂的task首先我們在命令面板裡,搜尋「配置任務」(Configure Task)並執行。

我們能夠看到一個下拉框,這裡面提供了多個不同的選項。

此處存在兩種自訂task 的方案task.json如果我們選擇第一個,也就是npm: install這一項的話,VS Code 會立刻在資料夾下建立一個tasks.json 文件,它的格式是JSON,可讀性很好且易於修改。 其中 tasks 屬性的值是一個數組,這就是我們可以在目前資料夾下使用的所有任務,接下來我們詳解任務物件的資訊。 意義type
#根據指令產生
.vscode
{
 // See https://go.microsoft.com/fwlink/?LinkId=733558
 // for the documentation about the tasks.json format
 "version": "2.0.0",
 "tasks": [
  {
   "type": "npm",
   "script": "install",
   "problemMatcher": []
  }
 ]
}
登入後複製
屬性
代表著你要使用哪個腳本工具############script######腳本工具執行的哪個腳本指令###########problemMatcher##### #設定自動地去分析任務運行結果的規則,下文詳解############

但是这种类型的任务,受限于 VS Code 或者插件所支持的脚本工具,缺乏一定的灵活性。

使用模板创建 tasks.json 文件

手把手帶你了解vscode中的倉庫配置

紧接着 VS Code 就问我们了,希望使用哪种模板。这里模板的多少,同样取决于你装了哪些插件。默认情况下,VS Code 为 MSBuild、Maven、.NET Core 提供了模板,而最后一个 Others,则是一个通用的模板,我们一起来看下它。

手把手帶你了解vscode中的倉庫配置

选择完 Others 之后,VS Code 在当前文件夹根目录下的 .vscode 文件夹中,创建了 tasks.json 文件。

手把手帶你了解vscode中的倉庫配置

{
 // See https://go.microsoft.com/fwlink/?LinkId=733558
 // for the documentation about the tasks.json format
 "version": "2.0.0",
 "tasks": [
  {
   "label": "echo",
   "type": "shell",
   "command": "echo Hello",
    "group": "none",
   "presentation": {
    "reveal": "always",
    "panel": "new"
   },
   "options": {
    "cwd": "",
    "env": {},
    "shell": {
     "executable": "bash"
    }
   }
  }
 ]
}
登入後複製
属性含义是否必填 | 默认值
label任务的名字,执行任务时选择的 keytrue
type这个类型可以有两种选择,一种是这个任务被当作进程来运行,另一种则是在 shell 中作为命令行来运行。
command代表着我们希望在 shell 中运行哪一个命令,可以联合 args 属性使用true
args数组,在运行指定 command 的时候,args 里的每个值都会被当作其参数传入,注意事项很多,见下文[]
group分组,我们可以通过这个属性指定这个任务被包含在哪一种分组当中。这涉及到运行时的类别:运行测试任务” (Run Test Task) 、“运行生成任务” (Run Build Task)
presentation用于控制任务运行的时候,是否要自动调出运行的界面
options用于控制任务执行时候的几个配置,比如控制任务脚本运行的文件夹地址 “cwd”,控制环境变量 “env”,或者控制任务脚本运行的时候使用哪个 shell 环境。
dependsOn实现多任务执行
path相对项目根路径的相对路径,运行脚本时会先切换到这下面
扩展:group 属性,运行任务的分组

task属性中,还存在分组属性group,这就需要先了解Run task了,我们在命令面板中输入Run Task,会出现如下内容

手把手帶你了解vscode中的倉庫配置

运行任务在上文已经讲解过了;关键是【运行开发任务】和【运行测试任务】;功能都是一样的,提供任务列表,供用户选择执行,唯一不同就是vscode加了一个分类,这样便于用户定义任务时进行区分,而这个分类就是通过group属性定义的;

group 属性值含义对应执行命令
build将这个任务划分在打包任务列表中Run Build Task
test将这个任务划分在测试任务列表中Run Test Task
none将这个任务划分在默认任务列表中Run Task

而一般我们的打包或者测试任务都是固定且唯一的,这就意味着我们可以省略掉【选择命令】这一步,一键运行。如何设置呢?

"group": {
    "isDefault": true,
    "kind": "test" // 这是 Run Test Task 的一键执行命令;如果设定 Run Build Task 则 kind 的值为 build
   }
登入後複製
扩展:执行命令时的参数

task 对象定义中有一个属性args,是一个数组,在运行指定 command 的时候,args 里的每个值都会被当作其参数传入,如

{
  "label": "echo",
  "type": "shell",
  "command": "echo 'Hello World'"
}
登入後複製

我们可以改写为

{
 "label": "echo",
 "type": "shell",
 "command": "echo",
 "args": [
  "hello world"
 ]
}
登入後複製

但对于命令而言,不同的执行 shell 对空白符、$、引号等等都可能有不同的理解,这就意味着需要对参数进行转义规则的设定,所以 args 数组也可以存储对象

"args": [
        {
            "value": "Hello World",
            "quoting": "escape"
        }
]
登入後複製
keyvalue
value参数内容
quoting决定了该如何处理这段字符串

對於quoting而言,存在三個值的情況

escape預設值,任務系統會根據我們所使用的shell 的要求,對這段字串進行轉義#strong在bash 裡, 我們將會用單引號包裹這段字串weak在bash 我們則會使用雙引號來包裹這段字串
#意義
#########
举例而言

escape 下执行的脚本实际上是

echo Hello\ World
登入後複製

strong 下执行的脚本实际上是

echo 'Hello World'
登入後複製

weak 下执行的脚本实际上是

echo "Hello World"
登入後複製

上面我们是以 bash 作为 shell 进行分析的,那对于 cmd、powershell 等等呢?可以搜索 “quoting mechanism” 来查找,也可以查阅VS Code 关于 Task 参数转义部分的文档

扩展:多任务执行

实现同时运行多个任务,其实挺简单的,就是配置dependsOn属性,是个数组,存储着所有要执行的任务的label

举例,我希望执行runOrderFirst时,帮我同时启动微应用基座项目和其内部的 order 项目;

那我们可以配置如下 tasks.json,其中包含【启动基座】、【启动 order】的 task

{
            "label": "runMapp",
            "type": "npm",
            "script": "start:dev"
        },
        {
            "type": "npm",
            "script": "serve",
            "path": "apps/order/",
            "problemMatcher": [],
            "label": "runOrder",
            "detail": "启动 order"
        },
登入後複製

然后我们新增一个 task,用于聚合这两个,tasks.json内容变为如下

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "runMapp",
            "type": "npm",
            "script": "start:dev"
        },
        {
            "type": "npm",
            "script": "serve",
            "path": "apps/order/",
            "problemMatcher": [],
            "label": "runOrder",
            "detail": "启动 order"
        },
        {
            "label": "runOrderFirst",
            "dependsOn": [
             "runMapp",
             "runOrder"
            ]
        }
    ]
}
登入後複製

运行这个 task 即可,效果如下

手把手帶你了解vscode中的倉庫配置

这种启动项目的命令很常用,每次还得选下命令挺麻烦,我们可以利用分组的功能,将之设置为测试任务并默认,这样Run Test Task就可以直接执行了

 {
            "label": "runOrderFirst",
            "dependsOn": [
             "runMapp",
             "runOrder"
            ],
            "group": {
                "kind": "test",
                "isDefault": true
               }
        }
登入後複製

效果如下

手把手帶你了解vscode中的倉庫配置

运行任务

在控制面板中使用命令Run Task;然后选择对应的命令即可;

比如选择“echo”这个任务(这个就是我们在 label 里写的名字),按下回车后,VS Code 会问我们 “选择根据何种错误和警告扫描任务输出”,现在就选择第一个选项 “继续而不扫描任务输出” 好了。

手把手帶你了解vscode中的倉庫配置

例子

唤起 Chrome 浏览器,我们先实现在 mac 中唤起,再考虑通用。

首先:定义 task
{
 "version": "2.0.0",
 "tasks": [
  {
   "label": "chrome",
   "type": "process",
   "command": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
  }
 ]
}
登入後複製
其次:运行 task

我们运行看看它的效果,在控制面板中使用命令Run Task,然后选择chrome

1手把手帶你了解vscode中的倉庫配置

最后:考虑平台不同

如果使用的系统是 Windows 或者 Linux,那么这个任务就没法使用了,因为 Chrome 的地址完全对不上号。

所以我们可以修改task.json,为系统定制命令。

{
 "version": "2.0.0",
 "tasks": [
  {
   "label": "chrome",
   "type": "process",
   "command": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
   "windows": {
    "command": "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
      },
   "linux": {
          "command": "/usr/bin/google-chrome"
      }
  }
 ]
}
登入後複製

vscode 仓库配置之调试设置(launch)

调试,是最必不可缺的一环功能,对于大多数的 IDE 而言,因为使用对象确定而使用极其方便,比如 IDEA 之于 JAVA,甚至谷歌浏览器之于前端;而对于 vscode 这种区别于 IDE 的编辑器而言,这需要考虑更大的灵活性,这就需要配置文件实现了。

常规使用

考虑新手友好,vscode 会存在默认设置,即开箱即用的调试功能;以nodejs为例,分两步:设置断点,调试。

设置断点

有两个方案,可以在文件中输入关键词【debugger】;也可以在文件的左侧可以点上红点,效果一致;

调试

可以点击左侧的 debugger 按钮【一只甲壳虫图标】,也可以使用快捷键【cmd + shift + D】。然后选择要调试的程序类型,这时默认会对当前打开文件进行调试处理。

手把手帶你了解vscode中的倉庫配置

高阶使用:调试配置 launch.json

那如果需求不止单文件,而是对一个项目进行调试呢?或者对项目内的指定文件,这就需要launch.json文件了,同任务功能,这个文件也是在.vscode下。

如何创建

点击左侧的 debugger 按钮【一只甲壳虫图标】,或者使用快捷键【cmd + shift + D】唤起 debugger 面板后,存在创建入口点击,然后选中类型即会自动创建。

手把手帶你了解vscode中的倉庫配置

{
 // 使用 IntelliSense 了解相关属性。 
 // 悬停以查看现有属性的描述。
 // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
 "version": "0.2.0",
 "configurations": [
  {
   "type": "node",
   "request": "launch",
   "name": "启动程序",
   "program": "${file}"
  }
 ]
}
登入後複製
属性 作用 备注
type 代表着调试器的类型
request 代表着该如何启动调试器 [ launch | attach]  [ 直接启动代码并且调试 | 调试这个已有的代码进程]
name 就是这个配置的名字
program 告诉 Node.js 调试器,我们想要调试哪个文件 这个值支持预定义参数,如file{file}、{workspaceFolder}
如何书写

对于书写launch.json文件,我们有两个工具可以使用

  • 借助 VS Code 的调试器插件提供的模板

在创建launch.json时,会要求选择类型,从而创建对应的模板

  • 自动补全功能

另一个能够帮助到我们的,就是在书写配置属性的时候使用自动补全功能。当我们在书写新的属性时,按下 Ctrl + Space,就能够唤出建议列表,建议列表里提供了当前调试配置里可以使用的所有属性,然后我们就可以按需选用了

1手把手帶你了解vscode中的倉庫配置

尾声

        到此,仓库配置相关的分享就结束啦;这节的信息很多,而且因为编辑器的默认设置肯定是符合大部分场景需求的,所以我们大多数人很有可能从未接触过这些概念,但努力就是为了成为更好的自己嘛。

        举个场景吧,不白撒鸡血,前些日子开一个项目,希望接入保存自动格式化,也就是接入eslint+prettier,多数人入职时候这些就已经在项目里配置好了,我也一样,所以一开始有点懵,但还是想尝试,最后发现其实就是配置.vscode文件中setting.json文件,有兴趣的同学可以参考文末【关于实现项目代码风格统一的参考贴】,人家写的很好,我就不重写一篇了。

手把手帶你了解vscode中的倉庫配置

相关资料

关于实现项目代码风格统一的参考贴

  • VSCode 合理配置 ESLint+Prettier:https://juejin.cn/post/6899323798676307976
  • eslint 官网相关规则:http://eslint.cn/docs/rules/space-before-function-paren
  • 关于 prettier 配置的一些问题:https://www.jianshu.com/p/99e0c58f3ebf
  • vscode 自动保存格式化 prettier 和 eslint 规范冲突问题解决:https://www.itcan.cn/2020/09/12/vscode-prettier-eslint-format/

在配置文件里可以使用的预定义参数

  • Visual Studio Code Variables Reference

    https://code.visualstudio.com/docs/editor/variables-reference

学习文档

  • 戳此查看 VS Code 官方博客

    https://code.visualstudio.com/blogs

  • 戳此查看 VS Code 更新日志

    https://code.visualstudio.com/updates

  • 戳此查看 Erich Gamma 在 Goto Conference 上对 VS Code 的介绍

    https://www.youtube.com/watch?v=uLrnQtAq5Ec

更多关于VSCode的相关知识,请访问:vscode教程!!

以上是手把手帶你了解vscode中的倉庫配置的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:juejin.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
最新問題
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板