选项对话框:文本编辑器 > 常规

选项 ”窗格的此部分允许更改 Visual Studio Code 编辑器的全局设置。 可以通过从 Visual Studio 菜单栏中选择“工具选项”>并展开“所有设置文本编辑器>常规”部分来访问设置。> 这些设置分布在三个类别中: 常规显示粘滞滚动。 下图显示了“ 常规 ”部分中的设置:

“工具选项”窗格中“文本编辑器的常规设置”的屏幕截图。

选项 ”对话框的此部分允许更改 Visual Studio Code 编辑器的全局设置。 可以通过从 Visual Studio 菜单栏中选择 “工具>选项 ”并展开 “文本编辑器>常规 ”部分来访问设置。 这些设置分为两个类别:常规选项(包括粘滞滚动)和显示选项。 下图显示了“常规”类别中的设置:

“工具选项”对话框中文本编辑器常规设置的屏幕截图。

常规设置

以下 常规 选项可用于 文本编辑器

以下 常规 选项可用于 文本编辑器,包括 粘滞滚动的设置。

拖放文本编辑

选中此设置后,可以通过选择并使用鼠标将其拖动到当前文档或任何其他打开的文档中的其他位置来移动文本。

双击时选择子词

启用此设置时,双击将字词选择为单词中的 子词 ,而不是完整单词。 此作对于采用媒体大写样式的 API 名称非常有用,例如 MainCallbackRoutine。 根据双击单词时的光标位置,可以选择字词 MainCallback或者 Routine,而不是完整的 API 名称。

剪切或复制当前行而不选择

选择此设置时,可以剪切或复制光标定位的当前行,而无需首先选择该行上的文本或代码。

自动分隔符突出显示

选中此设置后,将突出显示分隔参数或项值对以及匹配大括号的分隔符字符。

跟踪更改

选择代码编辑器后,选择边距中将显示一条垂直黄色线,用于标记自最近保存文件以来更改的代码。 保存更改时,垂直线变为绿色。

跟踪模式

启用 修订时,可以将 跟踪模式 选项设置为要跟踪的更改类型: Git 更改文件更改

不带签名的自动检测 UTF-8 编码

默认情况下,编辑器通过搜索字节顺序标记或字符集标记来检测编码。 如果当前文档中未找到这两种编码,则代码编辑器会尝试通过扫描字节序列来自动检测 UTF-8 编码。 若要禁用编码的自动检测,请清除此选项。

遵循项目编码约定

选择此设置后, 添加到项目的 EditorConfig 文件中指定的任何特定于项目的代码样式设置 将替代任何本地代码样式设置。 本地设置是在“所有设置语言语言><”下的“选项”窗格中指定的,例如 C#>>Code Style > General。>

选择此设置后, 添加到项目的 EditorConfig 文件中指定的任何特定于项目的代码样式设置 将替代任何本地代码样式设置。 本地设置是在“文本编辑器><语言”下的“选项”对话框中指定的,例如 C#>>Code Style > General。

小窍门

若要详细了解编码约定及其应用方式,请参阅使用 EditorConfig 页面创建可移植的自定义编辑器设置

启用图像悬停预览

选中此设置后,如果将鼠标悬停在编辑器中的图像上,将显示显示图像预览的弹出窗口。

启用音频提示

选择此设置时,当编辑器中的插入符号到达时,Visual Studio 会播放音频提示,其中包含错误、断点或警告。 在 Diff 视图中查看文件时,当插入符号到达添加或删除行时,Visual Studio 也会播放提示。

注释

还可以使用 Windows 中的声音控制面板单独启用或修改这些音频提示。

启用鼠标单击以执行转到定义

选中此设置后,可以在单击鼠标时按 Ctrl 并将鼠标悬停在元素上。 此作会将你移动到所选元素定义的位置。

修改键

可以将“转到定义”作的 修饰键 设置为 AltCtrlCtrl + Alt

在速览视图中打开定义

选中此复选框可以在窗口中显示元素定义,而无需在代码编辑器中导航离开当前位置。 有关详细信息,请参阅 “如何:使用速览定义查看和编辑代码”。

粘滞滚动设置

文本编辑器>常规>粘滞滚动部分包括以下用于配置滚动行为的选项。

“工具选项”窗格中文本编辑器的粘滞滚动设置的屏幕截图。

“文本编辑器>常规”部分包括用于配置粘滞滚动行为的以下选项。

在编辑器窗口的可滚动区域中对当前范围进行分组

选中此复选框可启用 粘滞滚动将范围粘附 到编辑器顶部,以便在 滚动 代码时始终处于视图中。 范围包括命名空间、类、方法、循环初始化语句和条件。 此设置在 Visual Studio 2022 版本 17.5 及更高版本中可用。 粘滞滚动支持的编程语言和代码格式包括 C#、C++、XAML 和 JSON。

最大粘滞线

设置为默认值 5,可以增加或减少要在粘滞滚动标题区域中看到的行数。

当范围数超过最大值时

默认值为 “首选”外部作用域,其中显示了更高级别的范围。 可以将它更改为 “首选内部范围”,这在滚动浏览深度嵌套代码时会推出更高级别的范围。 有关详细信息,请参阅 Visual Studio 页面“粘滞滚动”页的“内部和外部范围”部分。

显示设置

“文本编辑器>常规>显示”部分包括以下用于配置显示行为的选项。

“工具选项”窗格中文本编辑器的“显示”设置的屏幕截图。

显示空格

“文本编辑器>常规”部分包括以下用于配置显示行为的选项。

“工具选项”对话框中“文本编辑器显示设置”的屏幕截图。

查看空格

选择此设置后,可以看到构成内容中空白的空格和选项卡。

启用换行时自动缩进

如果要在启用换行功能时自动应用缩进,请选择此选项。

显示双向文本控制字符

查看双向文本控制字符

选中此设置后,所有双向文本控件字符都呈现为代码编辑器中的占位符。

谨慎

此选项默认处于选中状态,以防止潜在的恶意攻击,该漏洞允许代码被误报。

以下代码片段显示了双向控制字符的示例:

/// <summary>
/// Bidirectional control characters can invert text direction,
/// which can be exploited to craft malicious code that looks benign.
/// </summary>
/// <example>
/// transferBalance(5678,6776, 4321, "USD");
/// </example>
internal readonly ImmutableArray<char> BiDiControlCharacters = ImmutableArray.CreateRange(new[] {
   '\u061c', // ALM: Arabic letter mark
   '\u200e', // LRM: Left-to-right mark
   '\u200f', // RLM: Right-to-left mark
   '\u202a', // LRE: Left-to-right embedding
   '\u202b', // RLE: Right-to-left embedding
   '\u202c', // PDF: Pop directional formatting
   '\u202d', // LRO: Left-to-right override
   '\u202e', // RLO: Right-to-left override
   '\u2066', // LRI: Left-to-right isolate
   '\u2067', // RLI: Right-to-left isolate
   '\u2068', // FSI: First strong isolate
   '\u2069', // PDI: Pop directional isolate
});

显示零角字符

查看零宽度字符

选择此设置时,将在代码编辑器中呈现零宽度字符。

以下代码片段显示了零宽度字符的示例:

/// <summary>
/// Zero-width characters can be exploited to craft identifiers
/// that look like other identifiers, but are in fact distinct.
/// </summary>
/// <example>
/// ab‌c‍d⁠efg
/// </example>
internal readonly ImmutableArray<char> ZeroWidthCharacters = ImmutableArray.CreateRange(new[] {
  '\u200b', // ZWSP: Zero width space
  '\u200c', // ZWNJ: Zero width non-joiner
  '\u200d', // ZWJ: Zero width joiner
  '\u2060', // WJ: Word joiner
  '\u206f', // Nominal Digit Shapes
  '\ufeff', // BOM: Zero width no-break space
});

显示选择边距

选择边距

选中此设置后,沿编辑器文本区域的左边缘显示垂直边距。 可以单击此边距以选择整行文本,或单击并拖动以选择连续文本行。

选择边距 选择边距关闭
HTMLpageSelectionMarginOn 屏幕截图 HTMLpageSelectionMarginOff 屏幕截图

启用大括号对着色

使用此设置时,大括号是颜色匹配的,因此你可以在代码中直观地区分每组左大括号和右大括号。 使用大括号着色可以更轻松地查看代码的范围并查找任何缺失的大括号。 该设置在 Visual Studio 2022 版本 17.6 及更高版本中可用。 C#、C++、TypeScript、JavaScript、Visual Basic 和 Razor 支持大括号对着色。

Visual Studio 中大括号对着色的示例的屏幕截图。

键入引号或方括号时自动环绕所选内容

使用此选项可以轻松地将文本括在引号或括号中。 输入引号或方括号时,Visual Studio 会自动添加结束引号或方括号。 继续键入时,将突出显示封闭字符中的文本。

显示指示器边距

指示器边距

选择此设置时,垂直边距显示在编辑器文本区域的左边缘之外。 单击此边距时,会看到与文本相关的图标和工具提示。 例如,断点或任务列表快捷方式显示在指示器边距中。 指示器边距信息不会打印。

突出显示当前行

选中此设置后,光标所在的代码行周围会显示一个灰色框。

显示结构参考线

选择此设置时,垂直线将显示在编辑器中,其中包含结构化代码块。 这些行可帮助你轻松识别各个代码块。

显示错误波形曲线

选择此选项后,代码中会显示不同颜色的波浪下划线(波浪线)。 红色波浪线表示语法错误,蓝色表示编译器错误,绿色表示显示警告,紫色表示表示其他类型的错误。

显示选择匹配项

选择此设置时,Visual Studio 会在编辑器中选择文本后自动突出显示匹配的字符串。 具体而言,只要选择了 100 个字符或更少的单行文本,任何匹配项都将被突出显示。

显示文件运行状况指示器

选择此选项后,编辑器左下角会显示文件运行状况指示器(错误、警告)栏。 条形图状态包括代码清理选项。

行距

使用此控件可将默认行距 1.0 更改为所需的增量。 可以从 1.0、1.15、1.5、2.0、2.5 和 3.0 中进行选择。

大纲显示边距样式

使用此控件可更改 IDE 中边距扩展器的可见性。 可以使用以下选项:

  • 在悬停时显示扩展器
  • 在悬停时显示扩展器和垂直线
  • 始终显示扩展器和垂直线

在编辑器中显示编辑上下文

使用此控件可以完全切换编辑上下文设置,或通过从以下设置中进行选择来个性化设置:

  • Line/Col
  • Selection
  • 选择状态
  • 插入/覆盖
  • Tab/空格
  • 行尾
  • 编码
  • Line/Col
  • 选择
  • 插入/覆盖
  • Tab/空格
  • 行尾