新的介绍内容：

VSCode-Alternate-File：提升开发效率的利器

在Vim中，通过按:A键，你可以轻松切换到当前缓冲区的“备用文件”（通常是实现文件的测试文件，反之亦然）。VSCode-Alternate-File扩展将这一功能带到了VS Code中，让开发者能够更高效地在实现与测试文件之间切换。

核心功能：

• 初始化投影文件：在当前工作区根目录创建新的.projections.json文件。您可以传入一些框架名称以获取合理的投影默认值。
• 切换到备用文件：在当前窗格中切换到备用文件（如果找到）。
• 在分屏中切换到备用文件：在分屏中切换到备用文件（如果找到）。
• 创建备用文件：在当前窗格中切换到备用文件（如果找到），如果未找到则创建该文件。
• 在分屏中创建备用文件：在分屏中切换到备用文件（如果找到），如果未找到则创建该文件。

.projections.json配置文件

为了描述项目的布局，您可以在项目根目录创建一个.projections.json文件。

每个条目应以实现文件的模式作为键，并以包含备用文件模式的对象作为值（通常是测试文件，但也可以是任何您想要的文件）。在主要模式中使用，在备用模式中使用{}来标记两个文件之间应保持相同的路径部分。可以代表任意深度的路径。

路径拆分：

如果您的测试路径中间有一个额外的目录，例如Jest中的app/some/path/test/file.test.js，您可以使用{dirname}表示目录路径，{basename}表示文件名。在实现文件侧，您可以使用标准的glob语法：*表示目录路径，表示文件名，例如app/*/something/.js。

如果您的路径有多个可变部分，这也没问题！您可以使用多个**/{}对，例如：

"apps/**/lib/**/*.ex": {
  "alternate": "apps/{dirname}/test/{dirname}/{basename}_test.exs"
}

多重备用文件：

如果您的项目在测试文件的位置上不一致（这很常见），您也可以传递一个数组给alternate。扩展将首先查找与第一个备用文件匹配的文件，然后是第二个，依此类推。当您创建一个备用文件时，它将始终遵循第一个模式。

请注意，这不是原始Projectionist规范的一部分，但有时很有用。

示例：

{
  // 基本
  // app/foo/bar/file.js => app/foo/bar/file.spec.js
  "app/*.js": { "alternate": "app/{}.spec.js" },
  // 目录名/文件名
  // app/foo/bar/file.js => app/foo/bar/__test__/file.test.js
  "*.js": { "alternate": "{dirname}/__test__/{basename}.test.js" },
  // 实现文件的全局匹配：
  // app/foo/bar/js/file.js => test/foo/bar/file_test.js
  "app/**/js/*.js": { "alternate": "test/{}/_test.js" },
  // 多重备选
  // app/foo/bar/file.jsx =>
  //   app/foo/bar/file.spec.jsx 或 app/foo/bar/file.spec.js 或
  //   spec/js/foo/bar/file_spec.js
  "app/*.jsx": { "alternate": ["app/{}.spec.jsx", "app/{}.spec.js", "spec/js/{}_spec.js"] }
}

对于流行框架的.projections.json文件示例，请查看sample-projections。如果您的框架不在其中，欢迎为新样本投影文件提交PR！

快捷键设置

默认情况下没有设置快捷键。如果您想添加一些快捷键，可以在命令面板中选择“打开键盘快捷方式文件”，并添加如下内容：

{
  "key": "ctrl alt a",
  "command": "alternate.alternateFile",
  "when": "editorTextFocus"
}

命令包括：

alternate.alternateFile
alternate.alternateFileInSplit
alternate.createAlternateFile
alternate.createAlternateFileInSplit

VSCode-Vim支持：

如果您使用vscode-vim，可能更容易添加一个leader-key快捷方式，像Spacemacs中的备用文件命令一样：

{
  "vim.normalModeKeyBindingsNonRecursive": [
    {
      "before": ["", "p", "a"],
      "commands": [{ "command": "alternate.alternateFile" }]
    },
    {
      "before": ["", "p", "s"],
      "commands": [{ "command": "alternate.alternateFileInSplit" }]
    }
  ]
}

遗憾的是，您似乎无法向vscode-vim添加自己的ex命令，因此无法设置:A。

贡献代码

核心逻辑在alternate-file中实现。任何对匹配和查找逻辑的更改都应在此处进行。

设置：

克隆仓库，然后：

npm install

运行集成测试：

点击侧边栏中的调试按钮并运行扩展测试

或者在CI中运行：

npm test

部署到本地VS Code：

点击侧边栏中的调试按钮并运行扩展

构建本地包：

npm i -g vsce
vsce package --yarn

部署：

npm version major|minor|patch
vsce publish --yarn

未来规划

• 支持模板以自动填充新文件。
• 支持Projectionist的所有转换，而不仅仅是dirname和basename。
• 支持.projections.json中的"type"属性，并允许按文件类型查找，例如"controller/view/template"。