很多用 Mac M1/M2 的朋友在安装 Sublime Text 插件时，常常卡在几个常见问题上：Package Control 加载不了、装完插件没反应、或者 Debugger 一跑就崩。

说真的，大多数时候不是网卡，而是默认 Python 环境路径错位、shell 配置没生效、或者插件本身没有适配 ARM64 架构。

下面这套方案，基本能一次性把这些问题都理顺。

一、确认 Sublime Text 已正确安装并可调用 subl 命令

这一步如果跳过，后面基本白忙活。在终端里敲一下 subl --version，必须能看到版本号（比如 Sublime Text Build 4160）才行。否则 Package Control 的安装脚本会因为找不到主程序而静默退出，连个提示都没有。

如果看到报错 command not found: subl，直接回退用 Homebrew 安装：brew install --cask sublime-text。这条命令会自动把 subl 软链接到 /opt/homebrew/bin/subl，不用手动建链接，也绕开了 M1/M2 下 /usr/local/bin 权限异常的老问题。

关键前提：

• 当前 shell 必须是 zsh（macOS Catalina 开始默认就是这个）
• ~/.zshrc 里必须声明了 export PATH="/opt/homebrew/bin:$PATH"，并执行过 source ~/.zshrc

想确认的话，echo $SHELL 应输出 /bin/zsh，which subl 应返回 /opt/homebrew/bin/subl。缺一不可。

二、安装 Package Control（唯一可靠入口）

方法一：终端触发安装（推荐，绕过 GUI 阻塞）

在终端里执行 subl -w /tmp/install-pc.py，然后在打开的空白文件中粘贴最新安装脚本。按 Cmd+S 保存，接着按 Cmd+Shift+P，输入 Python: Run Current File 执行。这套流程基本不受网络波动影响。

方法二：快捷键直连（需确保网络直连 GitHub）

启动 Sublime Text，按 Cmd+Shift+P，输入 Install Package Control，回车等待完成。如果卡在“Downloading…”超过 30 秒，大概率是 DNS 被污染了，果断切到方法一。

安装成功后，菜单栏会出现 Preferences → Package Control 项。这时候别急着重启——Package Control 后台服务需要持续运行 5 秒以上才能完成初始化，强行重启会让后续插件装不上去。

三、安装 Debugger 调试插件（M1/M2 专用配置）

第一步：通过 Package Control 安装 Debugger

Cmd+Shift+P → Package Control: Install Package → 输入 Debugger → 选择 sublime_debugger（作者 da veleroy）→ 回车。

第二步：强制指定 LLDB 适配路径

Debugger 默认调用 /usr/bin/lldb，但 M1/M2 芯片的 Homebrew 版 LLDB 实际在 /opt/homebrew/bin/lldb。需要手动修改 Debugger 配置：
Cmd+Shift+P → Debugger: Settings – User → 在 JSON 中添加：
"adapter": {"type": "lldb", "command": "/opt/homebrew/bin/lldb"}

第三步：安装 CodeLLDB 适配器

在 Debugger 面板右上角点 + → Add Configuration → 选 CodeLLDB: Launch。它会自动下载适配 ARM64 的 codelldb 二进制（约 12 MB）。如果提示 Failed to download，手动下载地址是：
https://github.com/vadimcn/vscode-lldb/releases/download/v1.10.0/codelldb-x86_64-apple-darwin.vsix → 解压后将 extension/adapter/codelldb 复制到 ~/Library/Application Support/Sublime Text/Packages/Debugger/adapters/codelldb。

易错点：不要尝试安装 SublimeGdb——它依赖 x86_64 架构的 gdb，在 M1/M2 上根本没法编译运行，强行装 Sublime 会直接崩溃。

四、安装 Terminus 终端插件（替代原生终端）

直接装就行：Cmd+Shift+P → Package Control: Install Package → 输入 Terminus → 回车。装完不用额外配置，Cmd+Shift+P → Terminus: Open Default Shell in Panel 就能用了。它自动继承系统 PATH，能正确调用 /opt/homebrew/bin/python3 这类 M1/M2 专属路径下的命令。

如果新打开的 Terminus 窗口还是调用了 /usr/bin/python3（系统旧版），说明 shell 配置没生效。编辑 ~/.zshrc，确认里面有 export PATH="/opt/homebrew/bin:$PATH"，然后关掉所有 Sublime 窗口，重新打开。

五、验证插件是否真正生效

• 创建测试文件夹 ~/test-debug
• 放一个 main.cpp（内容写 int main(){return 0;} 即可）
• 执行 subl -n ~/test-debug
• 按 Cmd+Shift+P → Debugger: Toggle
• 点击左侧行号设断点
• 按 F5 启动调试

如果左侧出现了变量监视窗、堆栈跟踪，而且终端面板输出 Process exited with code 0，那么恭喜，Debugger + Terminus + LLDB 三者已经全链路打通，可以愉快调试了。

《夸克》非常好用的免费AI浏览器

下载APP查看