如何取消 Cursor 编辑器的自动格式化功能
方式 1:通过图形化设置界面(直观易懂)
- 打开 Cursor 配置界面:菜单:
File(文件)→Preferences(首选项)→Settings(设置) - 在配置搜索框中输入关键词
format on save - 找到「Editor: Format On Save」选项,取消勾选该复选框(若之前勾选了「Editor: Format On Paste」(粘贴时格式化),也可一并取消勾选)
- 关闭设置界面即可生效,后续保存文件将不再自动格式化
方式 2:通过 settings.json 文件配置(精准控制)
-
打开命令面板:
Ctrl + Shift + P(Windows/Linux)/Cmd + Shift + P(Mac) -
输入并选择
Preferences: Open Settings (JSON),打开配置文件 -
找到以下配置项,将其值改为
false(若没有该配置项,直接添加即可):json
// 取消保存时自动格式化 "editor.formatOnSave": false, // 可选:取消粘贴时自动格式化(若之前开启) "editor.formatOnPaste": false, // 可选:取消键入时自动格式化(若之前开启) "editor.formatOnType": false -
保存
settings.json文件,配置立即生效
进阶:彻底禁用格式化功能(隐藏手动格式化选项)
若你想完全关闭 Cursor 的格式化能力(包括手动触发的 Shift + Alt + F 等操作),可通过以下配置实现:
-
打开
settings.json配置文件 -
添加以下配置:
json
// 禁用默认格式化程序 "editor.defaultFormatter": null, // 禁用所有语言的格式化支持 "editor.formatOnSave": false, "editor.formatOnPaste": false, "editor.formatOnType": false, // 隐藏命令面板中的格式化选项(可选) "commandsToHide": [ "editor.action.formatDocument", "editor.action.formatDocumentWith", "editor.action.formatSelection" ] -
额外步骤:卸载已安装的格式化扩展(如 Prettier、black 等)
- 打开左侧扩展面板(
Ctrl + Shift + X/Cmd + Shift + X) - 找到已安装的格式化扩展,点击「Uninstall」卸载,彻底移除第三方格式化能力
- 打开左侧扩展面板(