使用 Visual Studio Code 创建 Azure 资源管理器模板Use Visual Studio Code to create Azure Resource Manager templates

Visual Studio Code 是一个轻型的多平台开源编辑器。Visual Studio Code is a lightweight, multiplatform, open-source editor. Azure 资源管理器模板工具扩展是用于资源管理器模板开发的插件。The Azure Resource Manager Template Tools extension is a plugin for Resource Manager template development. 该扩展增加了模板的语言支持,可提供 Intellisense、语法突出显示、内联帮助以及其他许多语言功能。The extension adds language support for templates to give you intellisense, syntax highlighting, in-line help, and many other language functions. 这些功能共同提供了推荐的模板开发体验。Together, they provide recommended template development experience.

安装 Visual Studio CodeInstall Visual Studio Code

Visual studio Code 支持 MacOS、Windows 和 Linux。Visual studio Code supports MacOS, Windows, and Linux. 可以从 Visual Studio Code 网站安装它。It can be installed from Visual Studio Code.

安装资源管理器工具扩展Install Resource Manager Tools extension

  1. 打开 Visual Studio Code。Open Visual Studio Code.

  2. 在左侧菜单中选择“扩展”。 Select Extensions from the left menu. 或者,在“视图”菜单中选择“扩展”打开“扩展”窗格。 Or from the View menu, select Extensions to open the Extensions pane.

    安装 Visual Studio Code 资源管理器工具扩展

  3. 搜索“资源管理器”。 Search for Resource Manager.

  4. 在“Azure 资源管理器工具”下选择“安装”。 Select Install under Azure Resource Manager Tools.

扩展功能The extension features

模板语言表达式的色彩含义Colorization for Template Language Expressions

参数、变量、函数、名称和表达式的颜色编码如以下屏幕截图所示:Parameters, variables, functions, names, and expressions are color-coded as shown in the following screenshot:

Visual Studio Code 资源管理器工具扩展 - 色彩含义

在模板大纲视图中可以轻松浏览大型模板。The template outline view makes it easy to navigate through large templates.

IntellisenseIntellisense

资源管理器模板扩展知道函数名称、参数、变量和引用的可能填写方式。The Resource Manager template extension knows possible completions for function names, parameters, variables and references. 键入时,会弹出 IntelliSense 建议。The IntelliSense suggestions pop up as you type. 如果你继续键入字符,成员(变量、方法等)列表将会筛选,仅包括带有所键入字符的成员。If you continue typing characters, the list of members (variables, methods, etc.) is filtered to only include members containing your typed characters. TabEnter 键会插入所选成员。Pressing Tab or Enter inserts the selected member.

  • 内置函数名称Built-in function names

    Visual Studio Code 资源管理器工具扩展 - Intellisense 函数

  • 参数引用Parameter references

    Visual Studio Code 资源管理器工具扩展 - Intellisense 参数

  • 变量引用Variable references

    Visual Studio Code 资源管理器工具扩展 - Intellisense 变量

  • resourceGroup() 属性resourceGroup() properties

    Visual Studio Code 资源管理器工具扩展 - Intellisense 函数

此外,Intellisense 还可处理 subscription() 属性,以及对变量(属于对象)的引用的属性。In addition, intellisense also works with subscription() properties and the properties of references to variables that are objects.

函数参数的签名帮助Signature help for function parameters

当鼠标悬停在函数名称上时,该扩展会显示函数参数的签名帮助。When hovering over function names, the extension shows the signature help for function parameters.

Visual Studio Code 资源管理器工具扩展 - 签名函数

转到变量和参数引用的定义Go To Definition for variable and parameter references

可以在按住 Ctrl 键的同时单击或者使用以下屏幕截图所示的上下文菜单跳转到定义:You can jump to the definition with Ctrl+Click, or by using the context menu as shown in the screenshot:

Visual Studio Code 资源管理器工具扩展 - 转到定义

可以在按住 Ctrl+Alt 的同时单击,在另一侧打开定义。You can open the definition to the side with Ctrl+Alt+Click.

速览变量和参数定义Peek for variable and parameter definitions

若要打开速览编辑器,请使用前一屏幕截图中所示的上下文菜单。To open peeked editor, use the context menu as shown in the previous screenshot.

以下屏幕截图显示了速览编辑器:The following screenshot shows the peek editor:

Visual Studio Code 资源管理器工具扩展 - 速览编辑器

查找变量和参数的所有引用Find all references for variables and parameters

若要查找所有引用,请使用前一屏幕截图中所示的上下文菜单。To find all references, use the context menu as shown in the previous screenshot.

以下屏幕截图显示了引用的突出显示方式:The following screenshot shows how the references are highlighted:

Visual Studio Code 资源管理器工具扩展 - 查找所有引用

重命名变量和参数的所有引用Rename all references for variables and parameters

若要重命名变量和参数的所有引用,请使用前一屏幕截图中所示的上下文菜单。To rename all references for variables and parameters, use the context menu as shown in the previous screenshot.

悬停鼠标显示参数说明Hover for parameter description

Visual Studio Code 资源管理器工具扩展 - 将鼠标悬停在定义上

括号匹配Brace matching

将光标靠近某个匹配括号时,会立即突出显示该括号。Matching brackets is highlighted as soon as the cursor is near one of them. 单击某个括号时,还会突出显示匹配的括号,如以下屏幕截图所示:When you click a brace, the matching brace is also highlighted as shown in the following screenshot:

Visual Studio Code 资源管理器工具扩展 - 括号匹配

显示错误和警告Show errors and warnings

该扩展识别的错误包括:The errors being identified by the extension include:

  • 未定义的参数引用Undefined parameter references
  • 未定义的变量引用Undefined variable references
  • 无法识别的函数名称Unrecognized function names
  • 变量定义中的 reference() 函数用法reference() function usage in variable definition
  • 函数中的参数数目不正确Incorrect number of arguments in functions

警告包括:The warnings include:

  • 未使用的参数Unused parameters
  • 未使用的变量Unused variables

后续步骤Next steps