Sublime Text macOS版需先拖入/Applications目录,再通过Homebrew或手动创建软链接配置subl命令,最后验证subl test.md、subl -n .及Package Control可用性。

如果您已下载 Sublime Text 的 macOS 版本但尚未完成安装与基础配置,则可能无法通过终端调用或快速启动编辑器。以下是完成安装、启用命令行工具及基础可用性验证的具体步骤:
一、从官网下载并拖入应用程序目录
此步骤确保 Sublime Text 应用程序被正确部署至系统标准路径,是后续所有操作的前提。未将应用放入 /Applications 目录会导致命令行链接失败或系统权限异常。
1、打开浏览器,访问 https://www.sublimetext.com/ 官方网站。
2、点击页面上的“Download for Mac”按钮,自动获取适用于 macOS 的最新 .dmg 文件。
3、双击下载完成的 Sublime Text.dmg 文件,挂载磁盘映像。
4、在弹出窗口中,按住 Ctrl 键并点击 Sublime Text 图标,选择“打开”,绕过首次运行时的“未知开发者”提示。
5、将 Sublime Text 图标拖拽至“Applications”文件夹图标上,系统开始复制应用。
6、等待复制完成,关闭挂载的磁盘映像窗口。
二、配置终端命令 subl(推荐 Homebrew 方式)
Homebrew 安装可自动注册 subl 命令至系统 PATH,并规避路径空格、权限错误及架构适配问题,适用于 Apple Silicon(M1/M2/M3)和 Intel 芯片机型。
1、若尚未安装 Homebrew,在终端中执行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、安装完成后,运行:brew install --cask sublime-text。
3、该命令会自动将 subl 可执行文件软链接至 /opt/homebrew/bin/subl(Apple Silicon)或 /usr/local/bin/subl(Intel)。
4、执行 subl --version 验证是否输出版本号(如 Build 4169)。
三、配置终端命令 subl(手动创建软链接方式)
适用于已通过 .dmg 安装且不希望引入 Homebrew 的用户。此方法需精确匹配应用名称与路径结构,否则链接无效。
1、在终端中执行:ls /Applications | grep -i "sublime",确认实际应用名称(如 Sublime Text.app 或 Sublime Text 4.app)。
2、根据上一步结果,执行对应命令:
若为 Sublime Text.app:sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl;
若为 Sublime Text 4.app:sudo ln -s "/Applications/Sublime Text 4.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl。
3、输入管理员密码后,运行:ls -l /usr/local/bin/subl,确认输出中包含有效指向路径。
4、检查 PATH 是否包含 /usr/local/bin:echo $PATH | grep -o "/usr/local/bin";若无输出,则向 ~/.zshrc 追加:export PATH="/usr/local/bin:$PATH",再执行 source ~/.zshrc。
四、验证与基础使用测试
此步骤确认编辑器已可被系统识别并响应常见操作指令,排除路径、权限或 shell 配置层面的残留问题。
1、在任意终端窗口中,进入一个存在文本文件的目录,例如 Desktop:cd ~/Desktop。
2、新建测试文件:echo "# Test" > test.md。
3、执行:subl test.md,观察是否成功唤起 Sublime Text 并打开该文件。
4、另开终端窗口,执行:subl -n .,确认是否以新独立窗口打开当前目录为项目根目录。
5、返回 Sublime Text,按下 Command + Shift + P,输入 install package,查看是否出现 Package Control 相关选项。

















