不能。sublime text 3 不原生支持 rst 预览,仅提供语法高亮与编辑功能;预览必须依赖外部工具(如 sphinx 或 docutils),并通过插件桥接调用命令行实现。

Sublime Text 3 能否原生支持 RST 预览?
不能。Sublime Text 3 自身不解析 .rst 文件,也不提供 HTML 渲染能力。它只做语法高亮和基础编辑,预览必须依赖外部工具(如 sphinx-build)或插件桥接。
安装 reStructuredText 插件并配置 Python 解释器
插件名是 reStructuredText,不是 rst 或 rest —— 搜索时拼写错误会导致找不到。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 → 输入reStructuredText→ 选中安装 - 安装后打开一个
.rst文件,右下角状态栏应显示reStructuredText语法标识;若仍为Plain Text,需手动点击状态栏切换 - 该插件默认调用系统
python命令,但如果你用的是 Anaconda、pyenv 或虚拟环境,需在Preferences → Package Settings → reStructuredText → Settings – User中显式指定解释器路径:{"python_binary": "C:/Users/xxx/Anaconda3/python.exe"}(Windows 路径用正斜杠或双反斜杠)
启用浏览器预览与常见失败原因
插件本身不带内置预览服务,它依赖你本地已安装的 sphinx 或 docutils。预览触发后,实际执行的是命令行调用,失败几乎都源于环境链路断裂。
- 先确认终端能运行:
sphinx-build --version或rst2html.py --version;若报'sphinx-build' is not recognized,说明未安装或未加入 PATH - 推荐安装完整 Sphinx:
pip install sphinx(不是仅docutils),因插件默认走sphinx流程 - 预览快捷键默认是
Ctrl+Shift+R(非Ctrl+R),触发后若无反应或弹出空页,检查 Sublime 控制台(Ctrl+`)是否有类似error: [Errno 2] No such file or directory: 'sphinx-build'的报错 - 若项目含
conf.py,插件会尝试用sphinx-build -b html . _build/html构建;否则降级使用rst2html.py,但数学公式、自定义角色等高级特性将不可用
避免中文路径和编码导致的构建崩溃
这是 Windows 用户最常踩的坑:Sphinx 对非 UTF-8 路径极其敏感,而 Sublime 默认用系统编码读取文件路径,一旦含中文,sphinx-build 极大概率直接退出且无明确提示。
- 确保
.rst文件保存为 UTF-8 编码(右下角状态栏点击编码名 → 选UTF-8) - 整个项目路径不能含中文或空格,例如
C:/work/rst-docs/可行,C:/我的文档/rst/几乎必挂 - 如果必须用中文目录,可在
Settings – User中强制设置工作目录:{"rst_default_build_dir": "C:/temp/rst_output"},让输出脱离源路径影响
真正卡住的地方往往不是插件配置,而是 Sphinx 是否真能跑起来、路径是否干净、编码是否一致——这三个点没对齐,所有快捷键和菜单项都只是摆设。











