sublime text python配置需三步:先用which python3确认路径并新建build system;再手动拖入package control插件文件安装;最后用pip3装pylint配合sublimelinter实现实时语法检查。

Sublime Text 装完就用不了 Python?先确认 python3 路径对不对
很多人装完 Sublime 就按 Cmd + B 运行 Python,结果报错:command not found: python3 或直接没反应——根本不是 Sublime 的问题,而是它压根找不到你的 Python 解释器。
Mac 上 python3 默认不在 /usr/bin/python3(那是系统自带的旧版),Homebrew 安装后通常在 /opt/homebrew/bin/python3(M1/M2)或 /usr/local/bin/python3(Intel)。必须手动告诉 Sublime 用哪个路径。
- 终端里先查清楚:
which python3 - 打开 Sublime →
Tools → Build System → New Build System… - 粘贴以下内容(把
/opt/homebrew/bin/python3换成你自己的路径):{"cmd": ["/opt/homebrew/bin/python3", "-u", "$file"], "file_regex": "^[ ]*File \"(.*?)\", line ([0-9]*)", "selector": "source.python", "shell": true} - 保存为
Python3.sublime-build(别漏掉扩展名),然后在Tools → Build System里选它
Package Control 装不上?别粘代码,直接拖文件进 Packages 目录
官方那段安装代码在较新 macOS(尤其是启用了 Full Disk Access 限制时)经常失败:控制台卡住、报 urlopen error,或者装完重启也没反应。这不是你网络差,是 Sublime 的沙盒机制拦截了远程加载。
更稳的办法是绕过网络,手动安装:
- 去 packagecontrol.io/installation 页面,右键下载链接,选择「另存为」,得到
Package Control.sublime-package - 在终端执行:
open ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/ - 把刚下的
Package Control.sublime-package文件直接拖进弹出的窗口里 - 重启 Sublime,
Cmd + Shift + P输入Install Package能出来,就成功了
想写 Python 别只装 Anaconda,SublimeLinter + pylint 才真防低级错误
Anaconda 插件看着功能全,但实际在 M1/M2 Mac 上常和 Python 虚拟环境冲突,补全失效、跳转报错;而单纯靠 Sublime 自带的语法高亮,根本发现不了 name 'x' is not defined 这类运行时才暴露的问题。
推荐组合更轻量、更可控:
- 先用
pip3 install pylint装好检查工具(不是pip install pylint,避免混用系统 Python) - 通过 Package Control 安装
SublimeLinter和SublimeLinter-pylint - 检查是否生效:在 Python 文件里写
prin("hello"),错误会实时标红,悬停看提示undefined name 'prin' - 如果没反应,打开
SublimeLinter → Preferences: Settings,确认"lint_mode": "background"已开启
subl 命令打不开当前目录?权限和 Shell 配置都得动
很多人按指南跑 ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl,结果终端输 subl . 报 Permission denied,或者只开空白窗口不加载项目——问题出在两处:一是符号链接权限,二是 shell 初始化文件没重载。
- 先删旧链接:
rm /usr/local/bin/subl - 重建带执行权限的链接:
sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl(注意加-f和sudo) - 确认你用的是什么 shell:
echo $SHELL,如果是zsh(macOS Catalina 及之后默认),要编辑~/.zshrc,末尾加一行:export PATH="/usr/local/bin:$PATH" - 然后执行:
source ~/.zshrc,再试subl .
路径、权限、shell 配置这三块少一个,subl 就算装了也等于白搭。











