Shell-Format插件可解决VSCode中Shell脚本缩进混乱、换行随意、变量风格不统一等问题；需安装插件、配置默认格式化工具、启用保存时自动格式化，并确保文件语言模式为Shell Script。
如果您在VSCode中编写Shell脚本，但发现代码缩进混乱、语句换行随意、变量引用缺乏统一风格，则可能是缺少有效的Shell代码格式化支持。Shell-Format插件专为解决此类问题而设计，可自动对.sh文件执行标准化排版。
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装Shell-Format插件
该插件需通过VSCode扩展市场获取并启用，是后续所有格式化操作的前提基础。未安装则无法调用任何格式化命令。
1、点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在搜索框中输入Shell-Format。
3、在搜索结果中找到作者为foxundermoon的插件，点击“安装”按钮。
4、安装完成后点击“重新加载”使插件生效。
二、配置默认格式化工具为Shell-Format
VSCode需明确指定Shell文件的默认格式化程序，否则即使插件已安装，右键菜单或快捷键仍可能调用其他格式器甚至无响应。
1、按下Cmd + ,打开设置界面。
2、在右上角搜索框中输入default formatter shell。
3、在“Files: Default Formatter”设置项下，点击右侧下拉箭头，选择foxundermoon.shell-format。
4、滚动至设置末尾，勾选Editor: Format On Save以启用保存时自动格式化。
三、使用快捷键手动触发格式化
当需要即时调整当前编辑中的Shell脚本结构时，可通过键盘指令快速调用格式化功能，无需依赖鼠标操作或保存动作。
1、确保当前打开的文件后缀为.sh且内容为合法Shell语法。
2、按下Shift + Option + F（macOS）或Shift + Alt + F（Windows/Linux）。
3、观察编辑器右下角状态栏是否短暂显示Formatting with Shell-Format提示。
四、通过命令面板执行格式化
命令面板提供更可控的执行入口，适用于格式化失败时排查问题，或在禁用自动保存格式化的场景中精准调用。
1、按下Cmd + Shift + P（macOS）打开命令面板。
2、输入Format Document并回车。
3、若弹出格式化工具选择提示，确认选择Shell-Format而非其他选项。
五、验证Shell-Format是否正确识别语法范围
插件仅对被VSCode识别为Shell语言的文档生效，若文件语言模式错误（如被识别为Plain Text），格式化将静默失败。
1、查看VSCode窗口右下角状态栏最右侧，确认显示文字为Shell Script。
2、若显示为其他内容（如Plain Text），点击该区域。
3、在弹出的语言选择列表中，输入shell并选择Shell Script。
