[译]Visual Studio Code文档其1—基本使用

Visual Studio Code的基本使用

全文翻译自官方Docs，更新至1.3版本

Visual Studio Code的核心是一个代码编辑器。像许多其他代码编辑器一样，VS Code采用了普遍的UI设计，将显示所有可访问的文件及文件夹的目录树置于左侧，将文件内容编辑器置于右侧，并显示已打开文件的内容。

译者注：NodeJS方面VS Code是Sublime很好的替代品，不妨试试

文件、文件夹以及Project

VS Code以文件、文件夹为基础——你可以通过打开文件或文件夹来快速启动VS Code。

VS Code可以读写不同框架或平台中不同类型的文件。即便VS Code同时打开了package.json、 project.json、tsconfig.json甚至ASP.NET 5 Visual Studio的项目文件，VS Code仍然可以读取它们并为你提供相应的附加功能，如IntelliSense。

基本布局

VS Code拥有简洁且直观的界面布局，并为编辑区提供了最大化的区域，以提供足够的空间来浏览。
UI部分划分为以下四个区域：

• 编辑器：最主要的区域，用来编辑文件。可以以分栏的方式同时打开三个文件。

• 侧边栏：不同视图的显示区域。

• 状态栏：位于底部，显示已打开的project及正在编辑的文件的信息(类型、编码等)。

• 视图栏 ：位于最左侧，可以让你在不同的视图间进行切换，以及给予你额外特定的全局指示器。如应用Git时，project的变化会在其上显示相应的数字。

• 面板：在编辑区域下方可以打开面板来显示调试信息、警告错误抑或是控制台。

每次打开VS Code时，都会显示你上次退出时界面的状态。文件夹、布局以及已打开的文件都将是上次被保存的状态。

提示：你可以移动侧边栏至右手边(View, Move Sidebar)以及控制其是否显示(Ctrl+B)。

分栏编辑

你可以并排打开至多三个编辑器。

如果已经打开了一个编辑器，你可以有多种方式再打开一个编辑器与之并排：

• Ctrl(Mac: Cmd)+单击目录树中的一个文件

• Ctrl+\令当前窗口一分为二

• 在左侧目录树中的文件上右键选择Open to the Side

• 单击编辑器右上角的Split Editor按钮

• 拖拽文件到编辑区域的另一侧

打开另一个文件时，当前获得焦点的编辑器将显示该文件的内容。所以如果当前有两个并排的编辑器并想要打开文件foo.css到右侧的编辑器时，那么你需要确定右侧的这个编辑器是处于激活（获得焦点）状态（可以通过在编辑器内部单击的方式激活）的。

打开了多个编辑器并希望能快捷地从中切换时，只需要按住Ctrl(Mac:Cmd)键并按下1、2或者3即可。

提示：你可以通过左右拖拽编辑器标题栏来调整编辑器的位置，通过拖拽编辑器之间的分割线来调整它们的宽度。

Explorer 文件浏览器

文件浏览器用于浏览、打开或管理project中的文件及文件夹。

当使用VS Code打开一个文件夹之后，此文件夹中的所有内容都将呈现在文件浏览器之中。可以对其进行如下操作：

• 创建、删除、重命名文件或文件夹

• 通过拖拽的方式来移动文件或文件夹

• 使用右键菜单浏览更多操作

提示：可以通过拖拽一个外部文件到文件浏览器中的方式来复制此文件到project。

在VS Code中也可以很方便地使用其他的工具，比如命令行工具。如果想打开以当前工作目录下的命令行，可以在文件浏览器中选中该文件夹（或其下的某个文件）右击并选择右键菜单中的Open in Console。

右击某个文件或文件夹并选择Reveal in Explorer(Mac:Reveal in Finder)可以打开该文件或文件夹的本地目录。

提示：Ctrl+P可以快捷地根据文件名来搜索并打开这个文件。

默认地，VS Code在文件浏览器中排除了一些文件夹（比如.git）。使用设置中的files.exclude可以配置在文件浏览器中需要隐藏的文件夹的规则。

提示：这一点对于隐藏一些资源文件来说非常有用，比如Unity中的\*.meta以及TypeScript项目中的\*.js。Unitry中需要排除\*.cs.meata文件时，匹配规则应该是"**/*.cs.meta": true。

Open Editors

文件浏览器的顶部是Open Editors区域，这其中包含了你之前使用VS Code打开过的文件的列表。以下的操作会将文件列入Open Editors：

• 对一个文件进行了改动

• 在文件浏览器中双击文件

• 打开了一个非当前目录下的文件

只需在Open Editors中单击一项，该文件就会在VS Code中被激活。

完成了某项工作时，你可以很方便地从Open Editors中单独移除某个文件，也可以通过Close All Files的操作来移除所有文件。

配置编辑器

在VS Code中，编辑器有许多可供配置的选项。选项依作用域保存在不同的地方，作用于全局的存于User Settings中，作用于某个project的存于Workspace Settings中。这些设定的值会保存在不同的settings.json文件中。

• 选择 File > Preferences > User Settings (或者Ctrl+Shift+P, 输入user再按Enter)来编辑User的settings.json文件。

• 选择 File > Preferences > Workspace Settings (或者Ctrl+Shift+P, 输入worksp再按Enter)来编辑Workspace的settings.json文件。

对Mac用户的提示:Preferences菜单在Code下而不是File下，例Code > Preferences > User Settings。

打开User或者Workspace的设置后，VS Code左侧会显示默认设置(Default Settings)，右侧会显示可编辑的settings.json，在右侧添加左侧中的设定名称并附上值就可以覆盖默认值了。

编辑好想要修改的设置后，使用Ctrl+S保存，新的设置会立即生效。

保存 / 自动保存

默认地，VS Code需要手动Ctrl+S来保存文件改动到硬盘中。

十分便捷的Auto Save功能可以在空闲时为你保存文件的改动，而当这项功能开启时，就无需手动保存文件了。

打开或者关闭Auto Save：打开命令面板(Ctrl+Shift+P)，接着输入auto过滤显示列表，找到Auto Save回车即可。

当然，你也可以在菜单File中找到这项功能。

搜索

VS Code可以在当前已打开的文件夹下所有的文件中快速搜索内容，只需要按下Ctrl+Shift+F并输入关键词即可。搜索结果将以分组的方式显示包含该关键词的文件，并标记出关键词出现次数和所在位置，单击一个结果即可打开其所在的文件。

提示：搜索内容支持正则表达式。

使用Ctrl+Shift+J可以打开高级搜索，为搜索提供额外的过滤条件。

高级搜索中搜索栏下的两个输入框，分别是填写的需要包含和排除的某些文件。单击输入框右侧的按钮(Use Glob Patterns)以确保当前支持Glob Pattern语法：

• *匹配一个或多个任意字符（译者注：a*.js -> app.js）

• ?匹配一个任意字符（译者注：ap?.js -> app.js）

• **匹配任意数量的任意字符，即所有

• {}分组条件（例：{**/*.html,**/*.txt}将匹配所有html以及txt文件）

• []定义字符的范围（例： example.[0-9]将匹配example.0或example.1）

VS Code默认排除了一些你不感兴趣的目录（比如node_modules）以优化搜索的结果，当然，你也可以对此使用files.exclude和search.exclude section进行设置。

提示：在文件浏览器中的文件夹上右键Find in Folder将只会在该目录下进行搜索。

当然，你可以在搜索的同时去替换文本。显示替换输入框的方法如下图：

在替换输入框内输入文本时，下方会显示出替换前后的对比。替换所有文件或单个文件中匹配结果，抑或是替换某一处匹配结果，可以自行选择。

命令面板

使用快捷键Ctrl+Shift+P可以打开命令面板，你可以通过它来调用所有VS Code的功能，这其中还包括能使用快捷键控制的常用操作。

在编辑器中的一些操作，打开指定文件、搜索symbol或者查看文件大纲等操作都可以使用命令面板来完成。下面是一些提示：

• Ctrl+P：输入相应名称即可快速地打开文件或symbol

• Ctrl+Tab：快速地从打开过的文件中切换

• Ctrl+Shift+O将指向你所指定的symbol所在文件中的位置

• Ctrl+G跳至指定行数

在输入框内键入?将显示可执行命令的列表：

文件切换

当你浏览一个project时，文件浏览器能很好地在众多文件中切换。然而，你也会遇到只在几个固定的文件中切换的情况，这个时候文件浏览器就显得不那么方便了。为此，VS Code提供了两组非常好用的快捷键以应对这种情况。

按下Ctrl+Tab时，将显示从你启动VS Code后你打开过的文件的列表。（译者注：但从Open Editors关闭的话就不会出现在该列表了）想要打开其中的文件的话，按住Ctrl(Mac:Cmd)并按下Tab选择需要切换的文件即可。

当然，也可以使用Alt+Left或Alt+Right来切换文件。如果需要在同一文件不同行之间快速跳转，你也可以使用这一对快捷键。

提示：想要快速地切换至任一文件的话，只需要Ctrl+P并输入文件名即可。

文件编码

使用file.encoding来指定VS Code的文件编码类型，在User Setting或者Workspace Settings中设置。

当前文件的编码类型可以在底部状态栏中看到。

在状态栏中点击编码类型可以选择以不同的编码类型来重新打开或保存该文件。

然后选择一种编码类型。

从命令行启动

从命令行启动VS Code可以快速打开一个文件、文件或者project。命令行切换到目标目录，然后输入：

code .

提示：我们在Mac和Linux的安装版本页面中做出了提示，告诉你该如何启动VS Code。我们也为Windows用户自动添加了VS Code的环境变量。

想要打开一个文件时，如果该文件不存在，我们将为你自动创建：

code index.html style.css readme.md

提示：可以用空格分隔文件名来同时打开多个文件。

命令行参数

下面是一些code命令可选的参数。

参数	描述
-g或--goto	配以file:line:column时可以定位到文件中指定的位置，列数为可选。如果文件名中包含:，那么该参数为必须。
-n或--new-window	打开一个新的VS Code窗口
-r或--reuse-window	使用当前VS Code窗口打开文件或文件夹
file	指定需要打开文件的名称。如果文件不存在，将自动被创建。该命令也可以指定多个文件。
folder	指定需要打开文件夹的名称，可以指定多个文件夹。

对于文件或是文件夹，都可以使用绝对或相对路径。相对路径指的是相对于你运行命令code的地方。

如果你在命令行指定多个文件或文件夹，VS Code将只开启一个实例。

打开Project

VS Code并不区分你打开的是文件夹还是project。无论你打开的文件夹里包含了什么文件，VS Code都会读取它们并在状态栏标记project状态。而如果文件夹中包含了多个project，你也可以从状态栏方便地切换project。（译者注：对于VS Code来说，project其实相当于文件夹的一个子集，可以把project看作是一种特殊的文件夹）

要打开project所在的文件夹c:\src\WebApp：

code c:\src\webapp

换言之，要打开一个包含project的文件夹其实就是要打开这个project：

窗口管理

VS Code有一些选项可以控制窗口是需要被新建还是复用。

window.openInNewWindow可以让VS Code在打开文件时新建窗口，而不是继续使用已有的窗口。默认地，VS Code会新建窗口（当你双击一个外部文件或者从命令行打开一个文件时）。设置这个属性为false的话，打开文件将使用当前已有的窗口。

设置window.reopenFolders将告诉VS Code该如何启动。默认地，VS Code将打开上次的project（值：one）。设置为never后，VS Code启动时则会打开一个空的project。设置为all后，VS Code将开启你上次工作过的所有project窗口。

常见问题

问：可以全局检索并替换吗？

答：这个功能目前还没有实现，不过你可以期待它的出现。（译者注：全文检索VS Code是支持的，但是不能在同时替换）

问：文本换行该如何设置？

答：使用设置中的editor.wrappingColumn(默认值300)来控制每一行的长度，超过即换行，设置为0则不换行。

使用Alt+Z可以控制文本换行的开启或关闭状态，重启VS Code将读取已保存的editor.wrappingColumn的值。

问：我该如何使得OPEN EDITORS区域显示更多的文件？

答：通过explorer.openEditors.visible可以设置显示条目的最大数量，explorer.openEditors.dynamicHeight可以设置其为自动高度。