macOS安装Sublime Text需完成官方拖拽安装或Homebrew一键部署，并手动配置subl命令行工具及安装Package Control插件管理器，最后验证图形界面、终端调用与插件功能正常。
如果您希望在 macOS 系统上安装 Sublime Text 编辑器，但尚未完成部署或遇到启动异常、终端命令不可用等问题，则可能是由于安装流程未完整执行或关键配置缺失。以下是解决此问题的步骤：
一、通过官网下载并拖拽安装
该方法适用于所有 macOS 版本，无需依赖第三方工具，直接获取官方原版应用。Sublime Text 的 macOS 安装包为 DMG 格式，需手动将其置入系统应用程序目录才能被系统识别。
1、打开浏览器，访问 Sublime Text 官方网站 https://www.sublimetext.com。
2、点击页面上的“Download for Mac”按钮，自动下载 Sublime Text.dmg 文件。
3、下载完成后，双击打开该 DMG 文件，在弹出窗口中将 Sublime Text 图标拖拽至“Applications”（应用程序）文件夹图标上。
4、等待复制完成，关闭 DMG 窗口。此时可在“应用程序”文件夹中找到 Sublime Text 应用。
5、首次运行时，若系统提示“已损坏”或“来自未知开发者”，请前往 系统设置 → 隐私与安全性 → 点击‘仍要打开’ 授权运行。
二、使用 Homebrew 一键安装（推荐）
Homebrew 是 macOS 上主流的包管理器，能自动处理路径注册与权限配置，避免手动创建软链接等易错环节，尤其适合后续需频繁调用 subl 命令的开发者。
1、打开终端，输入 brew --version 检查是否已安装 Homebrew；若未安装，请先访问 brew.sh 按指引安装。
2、执行命令：brew install --cask sublime-text。
3、安装完成后，直接在终端输入 subl --version，如返回版本号即表示成功注册。
4、该方式会根据芯片类型自动将 subl 命令注册至 /opt/homebrew/bin/（Apple Silicon） 或 /usr/local/bin/（Intel），无需额外配置 PATH。
三、手动配置 subl 命令行工具
若您已通过官网 DMG 安装，但终端中输入 subl 提示 command not found，说明命令未纳入 shell 搜索路径。需手动建立指向 Sublime Text 内部可执行文件的符号链接，并确保其所在目录位于 $PATH 中。
1、确认 Sublime Text 实际应用名称：在终端执行 ls /Applications | grep -i sublime，常见为 Sublime Text.app 或 Sublime Text 4.app。
2、创建软链接：执行命令 sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl（注意英文双引号包裹含空格路径）。
3、检查 PATH 是否包含 /usr/local/bin：输入 echo $PATH | grep -o "/usr/local/bin"；若无输出，则编辑 ~/.zshrc，追加 export PATH="/usr/local/bin:$PATH"。
4、使配置生效：执行 source ~/.zshrc。
5、验证：输入 subl --version，应显示版本信息。
四、安装 Package Control 插件管理器
Package Control 是 Sublime Text 的核心扩展管理工具，用于安装、更新和卸载插件。它不随主程序默认安装，必须单独初始化，否则无法使用任何第三方功能增强组件。
1、启动 Sublime Text，按下 Command + Shift + P 打开命令面板。
2、在输入框中键入 install package control，选择对应选项并回车。
3、等待状态栏显示 “Package Control installed” 提示，随后自动重启编辑器。
4、再次按下 Command + Shift + P，输入 install package，若出现 “Package Control: Install Package” 选项，即表示安装成功。
五、验证安装并启用基础功能
完成安装与命令行配置后，需通过典型操作确认各模块正常协同工作，包括图形界面启动、终端调用、项目打开及插件响应能力，排除残留权限或路径冲突问题。
1、在 Launchpad 或“应用程序”文件夹中双击 Sublime Text 图标，确认编辑器可正常启动且界面无报错。
2、打开终端，进入任意项目目录，执行 subl -n .（-n 表示新建独立窗口），观察是否以当前目录为项目根路径加载侧边栏。
3、在编辑器中按下 Command + Shift + P，输入 package control: install package，尝试搜索并安装 Emmet 插件，验证插件系统可用性。
4、在菜单栏点击 Sublime Text → 关于 Sublime Text，核对显示版本号与官网发布版本一致。
