You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

求助:如何移除Backstage界面的默认侧边栏?

移除Backstage侧边栏的可行方案

Backstage的默认侧边栏是可以移除的,以下是几种实用的实现方式:

方法1:修改根App组件布局

在packages/app/src/App.tsx文件中,直接调整页面布局结构,移除侧边栏组件:

  1. 找到原布局代码,通常类似如下:
import { AppRouter, Sidebar, Page } from '@backstage/core-components';

export const App = () => (
  <AppRouter>
    <Sidebar />
    <Page>
      {/* 页面内容容器 */}
    </Page>
  </AppRouter>
);
  1. 删除<Sidebar />标签,修改后代码:
import { AppRouter, Page } from '@backstage/core-components';

export const App = () => (
  <AppRouter>
    <Page>
      {/* 页面内容容器 */}
    </Page>
  </AppRouter>
);

如果你的项目使用AppLayout组件,只需给AppLayout传递sidebar={null}属性即可:

<AppLayout sidebar={null}>
  {/* 页面内容 */}
</AppLayout>

方法2:禁用侧边栏插件

侧边栏功能由@backstage/plugin-sidebar提供,你可以在插件注册文件中移除它:

  1. 打开packages/app/src/plugins.ts
  2. 删除包含sidebarPlugin的注册代码,比如:
// 移除这一行
import { sidebarPlugin } from '@backstage/plugin-sidebar';

// 并从plugins数组中删除sidebarPlugin项
export const plugins = [
  // ...其他插件
  sidebarPlugin, // 移除该行
];

重启Backstage应用后,侧边栏就不会加载了。

方法3:CSS全局隐藏(快速临时方案)

如果只是需要视觉上隐藏侧边栏,无需修改组件结构,可以添加全局CSS规则:
在packages/app/src/index.css中加入:

/* 隐藏侧边栏 */
.backstage-sidebar {
  display: none !important;
}
/* 调整主内容区宽度,消除侧边栏留白 */
.backstage-page-content {
  margin-left: 0 !important;
}

注意:不同Backstage版本的CSS类名可能有差异,需根据实际DOM结构调整选择器。

以上三种方法都能实现移除侧边栏的效果,根据你的实际需求选择即可——完全移除功能优先选方法1或2,临时隐藏选方法3。

内容的提问来源于stack exchange,提问作者Ben Martinez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.24 04:17:36