Project constraints of vscode you don't know | warehouse configuration

Zhiyuan Wang, WeDoctor Front-end Technology Department

foreword

Wel IDE, IDE focuses on out-of-the-box, so it is huge, such as Eclipse.

The editor focuses on rich support and freedom for languages and workflows, so it is more lightweight, which means that it does not do much for users for a certain language or aspect, but it also means that TA has a lot to do. High degree of freedom, such as plug-in mechanism, warehouse configuration mechanism, etc. This article focuses on warehouse configuration sharing, and the plug-in mechanism is a separate article.

Then let's start, rush rush!

v2-9c6182a96443f811e00edd8774d5cc4b_720w

Configuration overview

VS Code is managed based on folders, but VS Code allows you to create several configurations related to the current folder or the project and save them in this folder for easy sharing within the team. This folder is .vscode.

This folder can contain the following files.

Configuration file (settings.json)

It only takes effect if the current folder is opened in VS Code. It's the same as we said about modifying user settings.

Task Settings (tasks.json)

Configuration files for the VS Code task system

Debug settings (launch.json)

Used to illustrate how to debug code in the current folder

vscode repository configuration configuration file (settings)

As an editor, you naturally need to consider personal preferences and the uniformity of project styles during multi-person development, such as font size, line breaks, automatic formatting plugin configuration, etc. The corresponding function in VSCode is setting.jsonconfiguration

Configuration method

basic information

**User Settings **: User settings, the default configuration, will be associated with all projects, the weight is lower than the workspace settings

Workspace Settings : Workspace settings, configured for the project, not by default, you can create it yourself under the project root path, the project path/.vscode/settings.json

User Settings Entry: Using the UI Settings Interface

使用 Ctrl+,（mac 是 cmd+,）或者点击左下角齿轮图标并选择设置。然后在文本编辑器中找到 settings.json

用户设置入口：使用命令面板

使用 Ctrl+Shift+P （mac 是 cmd+shift+P）或者点击左下角齿轮图标，选择命令面板。然后输入 settings

Open User Settings 会打开 UI 设置界面；
Open Settings (JSON) 会打开用户设置 settings.json 文件；

工作区设置入口：.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 仓库配置之 tasks

任务系统的目的，是将各种形形色色的任务脚本尽可能地统一化，然后提供一套简单但又定制化强的方式操作它们

配置任务

任务的来源有两种：对项目的自动检测以及自定义的 task

对项目的自动检测

VSCode 会自动读取项目下的配置文件，通过配置文件类型生成task；

假设项目下有package.json，内容为

{
 "name": "sample",
 "scripts": {
  "test": ""
 }
}
复制代码

运行时就会发现默认有两条跟 npm 相关的任务：

npm install
npm test

自定义的 task

首先我们在命令面板里，搜索 “配置任务”（Configure Task）并执行。

我们能够看到一个下拉框，这里面提供了多个不同的选项。

此处存在两种自定义 task 的方案

根据命令生成`task.json`

如果我们选择第一个，也就是npm: install这一项的话，VS Code 会立刻在 .vscode文件夹下创建一个 tasks.json 文件，它的格式是 JSON，可读性很好且易于修改。

{
 // 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": []
  }
 ]
}
复制代码

其中 tasks 属性的值是一个数组，这就是我们可以在当前文件夹下使用的所有任务，接下来我们详解任务对象的信息。

属性	含义
type	代表着你要使用哪个脚本工具
script	脚本工具执行的哪个脚本命令
problemMatcher	设定自动地去分析任务运行结果的规则，下文详解

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

使用模板创建 tasks.json 文件

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

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

{
 // 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	任务的名字，执行任务时选择的 key	true
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加了一个分类，这样便于用户定义任务时进行区分，而这个分类就是通过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"
        }
]
复制代码

key	value
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 即可，效果如下

2021-07-07 11.30.33

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

 {
            "label": "runOrderFirst",
            "dependsOn": [
             "runMapp",
             "runOrder"
            ],
            "group": {
                "kind": "test",
                "isDefault": true
               }
        }
复制代码

效果如下

2021-07-07 11.33.06

运行任务

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

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

例子

唤起 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；

最后：考虑平台不同

如果使用的系统是 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】。然后选择要调试的程序类型，这时默认会对当前打开文件进行调试处理。

2021-07-08 11.42.39

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

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

如何创建

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

2021-07-08 11.51.43

{
 // 使用 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}、$ {workspaceFolder}

如何书写

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

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

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

自动补全功能

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

尾声

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

Let’s take a scene. It’s not a waste of blood. I started a project a few days ago, and I hope that the access and save will be automatically formatted, that is, access eslint+prettier. Most people have already configured these in the project when they join the job, and so do I. So I was a little confused at first, but I still wanted to try it. In the end, I found that it was actually the .vscodefile in the configuration file. setting.jsonInterested students can refer to the [Reference Post on Realizing the Unified Project Code Style] at the end of the article. They wrote it very well, so I will not rewrite it. one article.

thread_214569626974086_20201111224348_s_239569_o_w_178_h_154_73208

Series Article Directory

For the related sharing of vscode, it is roughly as follows, and the catalogue of the series of articles is as follows

Cursor Action : Completed
Space Control : Completed
Project Constraints | Repository Configuration: This Article
Plugin development: to be completed
Language support: to be completed

graph TB

A[Vscode] --> F[命令世界]
A[Vscode] --> D[语言支持]
A[Vscode] --> B[光标操作]
A[Vscode] --> C[空间控制]
A[Vscode] --> G[项目约束]
A[Vscode] --> E[插件开发]
B --> B1[光标移动]
B --> B2[多光标]
B --> B3[自定义]
C --> C1[编辑区]
C --> C2[终端区]
C --> C3[命令面板]
C --> C4[侧边栏]
G --> G1[调试 debugger]
G --> G2[任务 task]
G --> G3[代码块 snipshapt]

Relevant information

A reference post on realizing the uniformity of the project code style

VSCode configures ESLint+Prettier reasonably: juejin.cn/post/689932…
eslint official website related rules: eslint.cn/docs/rules/…
Some questions about prettier configuration: www.jianshu.com/p/99e0c58f3…
vscode auto-save formatting prettier and eslint specification conflict resolution: www.itcan.cn/2020/09/12/…

Predefined parameters that can be used in configuration files

Visual Studio Code Variables Reference

study documentation

Click here to view the official blog of VS Code

Click here to view the VS Code update log

Click here to see Erich Gamma's introduction to VS Code at the Goto Conference