很多人第一次用 Cursor 的时候,都会有个特别直观的困惑:活动栏怎么竖着排在左边?这跟我以前用的 IDE 不太一样啊。网上搜“cursor 工具活动栏怎么改垂直方向”的人特别多,甚至还有人在问怎么把菜单栏挪到左边去,说明这确实是大家上手时绕不开的一个界面习惯问题。
先说结论,Cursor 本身就是基于 VSCode 二次开发的,所以它的界面布局逻辑、快捷键、配置文件跟 VSCode 几乎一模一样。这意味着你以前折腾 VSCode 的所有经验,在 Cursor 里基本都能直接套用。但也因为这样,很多人会惯性思维地去找某个菜单按钮来拖拽活动栏,结果发现根本没有这个入口,这就很抓狂。这篇文章就专门把活动栏改成垂直形式这件事讲透,不光给你步骤,还会解释为什么它默认是竖排的、有哪些完全不同的布局风格可以切换、以及我在实际切换过程中踩过的坑和总结出来的效率技巧。
1. 先把概念盘清楚:活动栏、侧边栏、面板栏分别是啥
1.1 活动栏不是侧边栏,位置很关键
在动手之前,得先把 Cursor 界面里的几根“柱子”分清楚。默认布局从上到下、从左到右分别是:
- 活动栏(Activity Bar):位于整个窗口最左侧的一竖条,宽度很窄,通常只有 48 像素左右。上面有文件图标、搜索图标、源代码管理图标、运行调试图标、扩展图标。你光标放上去会弹出对应的小窗。
- 侧边栏(Side Bar):当你在活动栏上点了某个图标之后,展开出来的那块比较宽的区域。比如你点“文件”图标,侧边栏会显示资源管理器;点“搜索”,侧边栏就变成全局搜索框。
- 面板栏(Panel):位于窗口底部,可以放终端、输出、问题、调试控制台这四样东西。
很多人说的“工具活动栏”,就是最左边那一条竖着的窄条。Cursor 默认就是垂直排布的,也就是说,绝大多数情况下,你不需要做什么就已经是“垂直形式”了。那为什么还有这么多人搜“怎么改成垂直”?我猜有两种情况:一是有人从别的开发工具转过来,比如从 JetBrains 全家桶那种可以横向排列工具按钮的工具过来,以为默认的竖排是异常;二是有人想在“垂直”和“横向”两种布局之间切换,但找不到设置入口。
1.2 垂直与横向的几种布局风格
其实在 Cursor 里,跟“工具活动栏”相关的布局风格大致可以分成三类:
- 默认垂直窄条:活动栏里的图标从上到下竖排,每个图标旁边没有文字,纯粹图标显示。这是 Cursor 和 VSCode 的默认样式。
- 垂直宽条带文字:在设置里打开
workbench.activityBar.orientation的横向模式之后,活动栏会从最左侧移动到窗口顶部,变成一条横向的工具栏。这种模式下,图标旁边会带文字标签,像资源管理器、搜索、源代码管理这些名称会直接显示出来。 - 完整移动侧边栏:你甚至可以把整个侧边栏移到窗口右侧去,这个是在设置里用
workbench.sideBar.location来控制的,跟活动栏的方向是两码事。
我见过很多人把“侧边栏左右切换”和“活动栏垂直/水平切换”搞混,所以这里特别拿一节出来捋清楚,避免你照着教程改了半天发现还是不对。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 两种主要方案实测对比:改配置 vs 界面拖拽
2.1 方案一:拖拽图标,快速但容易半途而废
如果你用的是比较新的 Cursor 版本(0.45 以上),其实支持直接拖拽活动栏图标来调整顺序,甚至把某个图标拖到你不想看到的位置之外。
具体做法是:鼠标移动到活动栏空白处,按住某个图标(比如“搜索”),直接往上或往下拖动到目标位置,松开就行。想隐藏某个图标,可以右键活动栏空白处,会弹出一个显示/隐藏图标的下拉菜单,把勾选取消掉就不显示了。
这个方案爽是真爽,没有任何学习成本,所见即所得。但我不建议把它作为主力修改手段,原因有两个:
- 一是它受版本限制,旧版 Cursor 根本不吃这一套,你拖了没反应还以为自己电脑出问题了。
- 二是它能调顺序、能隐藏,但不能控制活动栏整体是“垂直还是水平”,这是两码事。想要跨布局切换,必须按下面的方案二来做。
2.2 方案二:改配置文件,通用且彻底
绕不开的还是配置文件。Cursor 的所有界面设置最终都落在 JSON 配置文件里,格式跟 VSCode 的 settings.json 完全兼容。你之前如果配过 VSCode,甚至可以把那套配置文件直接导进来用。
打开配置文件的路径很简单:按快捷键 Ctrl+Shift+P(Mac 上是 Cmd+Shift+P),在弹出的命令面板里输入“settings”或者“偏好设置”,选“Preferences: Open User Settings (JSON)”,就打开了。接下来在这个 JSON 文件里加一行:
json复制"workbench.activityBar.orientation": "vertical"
保存之后,活动栏马上变成最标准的竖排样式。
如果你改成:
json复制"workbench.activityBar.orientation": "horizontal"
保存之后,你会看到活动栏跑到顶部去了,图标从左到右排成一排,而且每个图标旁边会显示文字标签。这个模式其实是非常多人喜欢的,因为不用悬停就能看到每个图标是什么,对新人极度友好。
2.3 方案三:从设置界面改,适合怕敲代码的人
如果你连 JSON 配置文件都不想开,还有一条路:点击 Cursor 窗口右下角的齿轮图标,进入“Settings”界面。然后在搜索框里输入“Activity Bar”,就能看到:
Activity Bar: Orientation,下拉框里选vertical或horizontal,效果跟改 JSON 一样。Workbench > Side Bar: Location,这里可以改left或right,控制侧边栏在左侧还是右侧。
需要注意的是,设置界面里的选项是实时生效的。你选完不用保存,窗口马上就变,不喜欢再切回去就行,没有副作用。
3. 参数背后的门道:为什么这几个配置要这么设
3.1 orientation 参数的实际表现差异
我把 vertical(垂直)和 horizontal(横向)两种模式放在同一个项目里分别跑了一周,整理了一下实际体验差异:
| 参数值 | 活动栏位置 | 图标是否带文字 | 适合场景 | 主要缺点 |
|---|---|---|---|---|
vertical |
窗口最左侧竖排 | 不带文字,只有图标 | 屏幕宽度紧张、沉浸式写代码 | 新手可能不知道某个图标是干嘛的 |
horizontal |
窗口顶部横排 | 带文字标签 | 新手友好、宽屏显示、喜欢一目了然 | 占用顶部高度,屏幕矮的时候会挤代码区 |
这里有个隐藏细节:在 horizontal 模式下,活动栏的文字标签显示的是那些图标的 displayName,不是项目文件名,所以不存在文件名过长把活动栏撑爆的问题。这个模式比较适合刚迁移到 Cursor 的用户,因为你能直观看到“源代码管理”“运行和调试”这些名词,不用靠猜图标含义。
3.2 不要和 sidebar 配置混在一起
我见过太多人在问“活动栏怎么改垂直”的时候,把下面这两个配置也拉出来试:
json复制"workbench.sideBar.location": "right"
这个是把侧边栏从默认的左侧移到右侧,跟活动栏方向完全无关。
json复制"window.menuBarVisibility": "hidden"
这个控制菜单栏是否隐藏,也跟活动栏无关。
如果你把这些配置全部堆在一起改,很容易搞出“活动栏横向、侧边栏右侧、菜单栏隐藏”的诡异布局,然后一脸懵不知道怎么恢复。我的建议是:一次只改一个配置,改完刷新看效果,有印象了再动下一个。速度虽然慢一点,但你对整个界面布局的理解会清晰得多。
3.3 为什么很多人觉得默认垂直已经很好用
从我的使用经验看,代码编辑器这种东西,核心目的是最大化利用视觉空间,让你把注意力聚焦在代码区域。默认的垂直活动栏,窄窄一条,图标悬停有 tooltip 提示,既不占地方,又不妨碍操作,本质上就是这类型工具多年的最佳实践沉淀。因此新手刚开始用如果不适应,不要急着改成横向,先给自己两三天时间熟练图标位置,你会发现效率反而更高。
4. 实操演示:把 Cursor 活动栏从默认垂直改成横向再改回来
4.1 第一步:确认当前 Cursor 版本
改之前先看一下你的 Cursor 版本,因为不同版本的设置界面酷似但入口位置可能有细微差异。点击左下角齿轮图标,选“About”,能看到版本号。我写这篇文章时用的是 1.x 版本,配置文件路径和设置界面的关键词都还适用。
4.2 第二步:打开用户设置 JSON
按 Ctrl+Shift+P,输入“Open User Settings (JSON)”,回车,就进到了 JSON 编辑页。另外还有一个方法:按 Ctrl+,(逗号键)直接进入设置界面,右上角有一个花括号样式的图标,点一下也能切换到 JSON 视图。不瞒你说,这两个入口我每次都是随缘打开,哪个顺手用哪个。
4.3 第三步:追加配置项并验证
在 JSON 里,把光标移到最外层大括号内部,加一行:
json复制"workbench.activityBar.orientation": "horizontal"
然后按 Ctrl+S 保存,Cusor 会瞬间刷新界面。正常情况下,你应该看到:
- 活动栏从左侧消失
- 窗口顶部出现一排带文字的图标
这时候可以顺手检查一下左侧是不是完全空了。如果左侧还有东西,说明侧边栏还开着,按 Ctrl+B 可以快速切换侧边栏显隐,把它关掉。
4.4 第四步:改回来需要几步?
如果说横向模式用不习惯,想恢复默认垂直模式,步骤完全一样,只要把那行配置改成:
json复制"workbench.activityBar.orientation": "vertical"
保存即可。连 Cursor 重启都不用,界面是即时响应的。
还有一个隐藏小技巧:如果你连配置改动都懒得做,可以直接按快捷键 Ctrl+Shift+P,输入“Activity Bar Orientation”,也可以快速切换。这是命令面板里自带的操作,跟改 JSON 效果完全一致,算是比较冷门但好用的一个入口。
4.5 常见失败现场还原
第一种失败:我改了配置,界面没反应。这种事我踩过不下三次。原因通常是你改错了配置文件,改到了“工作区设置”而不是“用户设置”。工作区设置只对该项目生效,而且如果与用户设置有冲突,用户设置会被覆盖。解决方法是:在设置界面右上角,看清楚标签是“User”还是“Workspace”,能选 User 就选 User。
第二种失败:能改成横向,但重启之后又变回垂直了。这种情况通常是因为你同时装了 VSCode 插件里的某款主题或布局增强插件,它们会在启动时自动重置你的 workbench.activityBar.orientation。排查思路是禁用最近安装的布局类插件,或者直接把配置写到 keybindings.json 之外的全局设置里再看。
第三种失败:按 Ctrl+Shift+P 输入“Open User Settings (JSON)”没结果。有部分用户把 Cursor 默认的命令面板集成改掉了,或者是快捷键冲突。最笨也最稳的办法:左下角齿轮 → 设置 → 左上角搜索框输入“activity bar”,在下拉选项里直接改,不走命令面板,完全绕开快捷键冲突问题。
5. 工具选型延伸:三种常用布局方案的搭配建议
5.1 垂直活动栏 + 右侧侧边栏
说完了基础操作,再聊点进阶的搭配。
我之前有段时间特别喜欢把活动栏保留在左侧垂直显示,同时把侧边栏整体移到右侧。好处是代码区域的视觉重心更靠左,调试时借助右侧侧边栏快速看变量,思路不会被传统左侧导航干扰。配置如下:
json复制"workbench.activityBar.orientation": "vertical",
"workbench.sideBar.location": "right"
这个组合特别适合宽屏双屏用户,左右各有一块信息区域,代码区夹在中间,信息密度拉满。但对于单屏 14 寸以下的笔记本,说实话有点挤,慎用。
5.2 横向活动栏 + 隐藏菜单栏
如果你非常追求简洁,可以试试横向活动栏配合隐藏菜单栏的组合。活动栏在顶部,菜单栏隐藏掉,整个窗口结构就是“顶栏图标 + 侧边栏 + 代码区”,没有乱七八糟的下拉菜单。配置如下:
json复制"workbench.activityBar.orientation": "horizontal",
"window.menuBarVisibility": "hidden"
菜单栏隐藏之后,绝大多数常用操作都能通过快捷键和命令面板完成。唯一需要注意的是,如果你平时特别依赖鼠标点“文件→打开最近”,隐藏菜单栏之后这个入口就没了,得用 Ctrl+R(打开最近项目)代替。我自己刚开始隐藏菜单栏的那一周,确实不适应,总是下意识去左上角找“文件”,后面逼自己用快捷键,效率反而高了不少。
5.3 终极方案:让活动栏彻底消失
还有一种更极端的玩法:直接隐藏整个活动栏。在命令面板输入 View: Toggle Activity Bar Visibility,或者右键活动栏空白处选择“隐藏活动栏”,活动栏就消失了。这种布局适合极端专注模式,整个界面只剩侧边栏、代码区、底部的终端。想恢复的时候,按 Ctrl+Shift+P 再输入同样的命令即可。
不过我不太建议立刻这么做,除非你已经完全掌握了所有活动栏里图标的快捷键。比如你不知道 Ctrl+Shift+E 是文件资源管理器、Ctrl+Shift+F 是全局搜索,把活动栏隐藏了会明显影响工作流。先记住这几个快捷键,再玩隐藏,不然就是在给自己挖坑。
6. 常见问题速查表与避坑指南
这一节把你可能遇到的高频问题全部列出来,直接对着查就行。
6.1 关于界面配置的高频问题
| 问题描述 | 解决思路 |
|---|---|
| 活动栏改了横向,但图标排列乱序 | 在活动栏空白处右键 → “重置活动栏布局”,或者手动拖拽图标重新排序 |
| 活动栏没了,找不到恢复入口 | 按 Ctrl+Shift+P 输入 Toggle Activity Bar Visibility,或者检查 workbench.activityBar.visible 是否为 true |
| 改了配置但只对当前项目生效 | 确认编辑的是全局用户设置,不是工作区设置 |
| 界面配置想备份 | 直接把整个 JSON 保存下来,换电脑时导入即可,所有界面布局、主题、快捷键偏好全都在里面 |
| 配置无效且报错 | 检查 JSON 里是否使用了注释;如果是从 VSCode 导入的配置并且带注释,需要清理掉 Cursor 才能正常解析 |
JSON 配置文件是不允许写注释的,这一点很多人会忽略。VSCode 的配置文件虽然支持注释的写法但会标黄,到了 Cursor 里某些版本会直接无法保存,我被这个问题折磨过一次,后来养成了快捷键导出备份的习惯。
6.2 命令面板输入关键词对照
- 想切换活动栏左右位置:输入
Activity Bar Position(部分版本叫法不同),或者直接改配置workbench.activityBar.orientation - 想隐藏活动栏:输入
Toggle Activity Bar Visibility - 想切换侧边栏左右:输入
Side Bar Position,或改workbench.sideBar.location - 想隐藏菜单栏:输入
Toggle Menu Bar,或改window.menuBarVisibility
6.3 我的独门排查流程
如果你发现改完配置之后,界面纹丝不动,别急着重启。请按以下顺序排查:
- 确认你编辑的是否是要生效的那个配置文件(用户 vs 工作区)。
- 检查 JSON 里面该配置项的 value 是否拼写正确。
vertical少写一个字母变成vertcal,保存不会报错,但也不会生效。 - 看 Cursor 窗口左下角有没有报错弹窗。有报错就点开,通常能直接看到是哪一行配置格式有问题。
- 最后一步才是重启。因为绝大多数界面相关配置都是热更新,重启通常不是必须的。
- 如果重启也不行,大概率是插件冲突,禁用最近安装的界面增强插件再试。
7. 再聊点效率心得:界面布局也是生产力的一部分
很多人觉得折腾活动栏、侧边栏这种界面细节是在浪费时间,觉得写代码才是正事。但以我的亲身体验来说,一个顺手的工作界面,对长期编码效率的影响远比想象中大。你天天要用的工具,每省下零点几秒的寻找时间,日积月累就是把双倍的时间抢了回来。
我现在的个人配置是横向活动栏、右侧侧边栏、面板栏自动隐藏、菜单栏隐藏,整体界面很干净。刚切换过来的时候确实需要几天适应期,经常找不着某些按钮,但过了那几天之后,再让我换回全默认布局,我会觉得哪哪都别扭。
如果你用的是双显示器,可以考虑把 Cursor 的窗口放在主显示器,侧边栏朝向用来放资料的那个方向,这样鼠标不会频繁跨屏操作。这种细节属于“用久了才能发现的问题”,趁早规划能省很多事。
最后分享一个小技巧
活动栏里图标的顺序是可以自由拖拽的,这个很多人不知道。我习惯把最常用的“文件资源管理器”和“搜索”放在最顶上,把“源代码管理”这种不常点的放到中间去。拖拽方法极其简单:鼠标按住图标,往目标位置拖动,出现一个蓝色的插入条后松手就行。如果你发现拖不动,大概率是版本太旧,升级一下 Cursor 再试。所有界面布局改完以后,如果想恢复默认,可以直接在命令面板输入 重置布局(英文环境是 Reset View Locations),它会把你所有界面的位置重置回出厂状态,相当于一次后悔药。
