ClangFormat 2.0.2

ClangFormat for Visual Studio Code：现代化的代码格式化工具

ClangFormat for Visual Studio Code 是 xaverh/vscode-clang-format 的一个分支，自2019年以来没有发布新版本。我们的版本对代码库进行了清理和现代化处理，旨在为开发者提供更高效的代码格式化工具。

主要改进：

• 扩展设置位于 clangFormat 范围内，以避免与 xaverh/vscode-clang-format 冲突，并匹配扩展名（由于 microsoft/vscode-docs#5584 无法使用 clang-format）。
• 移除了 clang-format.{language}.* 设置，建议使用特定语言的编辑器设置。
• 支持更多语言。

使用 ClangFormat 格式化代码：

通过在文档中右键点击并选择“格式化文档”，或使用相关的键盘快捷键（Windows上通常为 Ctrl ⇧ F，Linux上为 Ctrl ⇧ I，macOS上为 ⇧ ⌥ F），可以按需格式化文件。

要在保存时自动格式化文件，请在您的 vscode settings.json 文件中添加以下内容：

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "seaube.clangformat"
}

如果您只希望为特定语言使用 ClangFormat，请使用特定语言的编辑器设置：

{
  "editor.formatOnSave": true,
  "[cpp]": {
    "editor.defaultFormatter": "seaube.clangformat"
  }
}

指定 clang-format 的位置：

此扩展将尝试在您的 PATH 中查找 clang-format。或者，您可以在 vscode settings.json 文件中指定 clang-format 可执行文件的位置：

{
  "clangFormat.executable": "/absolute/path/to/clang-format"
}

您还可以为不同平台指定不同的路径：

{
  "clangFormat.executable.windows": "/absolute/path/to/clang-format.exe",
  "clangFormat.executable.linux": "/absolute/path/to/clang-format",
  "clangFormat.executable.macos": "/absolute/path/to/clang-format",
}

clang-format.executable 值中还可以使用替代符。支持以下替代符：

• ${workspaceFolder} - 替换为当前 vscode 工作区的绝对路径。对于工作区外的文件，${workspaceFolder} 扩展为第一个可用工作区的绝对路径。
• ${cwd} - 替换为 vscode 的当前工作目录。
• ${env.VAR} - 替换为环境变量 VAR，例如 ${env.HOME} 将被替换为 $HOME，即您的家目录。

clang-format.assumeFilename 中也支持替代符。支持的替代符有 ${file}、${fileNoExtension}、${fileBasename}、${fileBasenameNoExtension} 和 ${fileExtname}，与其他配置文件中的预定义变量具有相同的含义。

例如：

• ${fileNoExtension}.cpp - /home/src/foo.h 将使用 -assume-filename /home/src/foo.cpp 进行格式化。

源代码：

源代码可在 GitHub 上获取：https://github.com/seaube/vscode-clang-format