English | 中文 | 日本語

vscode-background

给 Visual Studio Code 添加背景

全屏、编辑器、侧边栏、辅助栏(auxiliarybar)、面板、轮播、自定义图片/样式...

GitHub | Visual Studio Marketplace

多区域，编辑器、侧边栏、辅助栏(auxiliarybar)、面板

全屏

安装

有两种安装方式：

1. 从 Visual Studio Marketplace 安装。
2. 在 vscode 里搜索 shalldie.background。

自定义

可以通过调整配置（settings.json）来满足个性化需求。

settings.json 是什么 | 怎么打开

配置项

全局配置

Editor 编辑器区域配置

通过 background.editor 设置编辑器区域配置。

example:

{
  "background.editor": {
    "useFront": true,
    "style": {
      "background-position": "100% 100%",
      "background-size": "auto",
      "opacity": 0.6
    },
    "styles": [{}, {}, {}],
    // `images` 支持在线和本地图片，以及文件夹。
    "images": [
      // 在线图片，只允许 `https` 协议
      "https://hostname/online.jpg",
      // 本地图片
      "file:///local/path/img.jpeg",
      "/home/xie/downloads/img.gif",
      "C:/Users/xie/img.bmp",
      "D:\\downloads\\images\\img.webp",
      // 文件夹
      "/home/xie/images",
      // data URL
      "data:image/*;base64,<base64-data>"
    ],
    "interval": 0,
    "random": false
  }
}

全屏、侧边栏、辅助栏(auxiliarybar)、面板 区域配置

通过 background.fullscreen、background.sidebar、background.auxiliarybar、background.panel 来进行这些区域的配置。

example:

{
  "background.fullscreen": {
    // `images` 支持在线和本地图片，以及文件夹。
    "images": [
      // 在线图片，只允许 `https` 协议
      "https://hostname/online.jpg",
      // 本地图片
      "file:///local/path/img.jpeg",
      "/home/xie/downloads/img.gif",
      "C:/Users/xie/img.bmp",
      "D:\\downloads\\images\\img.webp",
      // 文件夹
      "/home/xie/images",
      // data URL
      "data:image/*;base64,<base64-data>"
    ],
    "opacity": 0.1,
    "size": "cover",
    "position": "center",
    "interval": 0,
    "random": false
  },
  // `sidebar`、`panel` 的配置与 `fullscreen` 一致
  "background.sidebar": {},
  "background.panel": {}
}

快捷命令

点击状态栏右下角「Background」按钮，可以快速弹出 background 所有命令：

常见问题

本插件是通过修改 vscode 的 html 文件的方式运行

如果遇到问题请查看 常见问题

卸载

请查看 常见问题#如何删除插件

感谢这些朋友的 pr 🙏

贡献指南

这里是 贡献指南。

更新日志

可以从 这里 查看所有的变更内容。

分享图片

我们在 这里 分享背景图。

从 v1 迁移

v1 的配置已经过时，当前保持一定的兼容性，请参考 migration-from-v1.md 进行迁移。

协议

MIT