stylus在sublime中需四步配置:1.手动绑定.styl语法;2.全局安装stylus cli并启用compileonsave;3.配置auto_complete_triggers支持冒号触发;4.vue内联块需vue syntax highlight插件而非stylus插件。

Stylus 文件没高亮、保存不生成 CSS、Vue 里 lang="stylus" 块还是白字——不是插件坏了,是四步配置缺了任意一环。
Stylus 插件装了但 .styl 文件全是灰色?先确认语法绑定生效
Sublime 不会自动把 .styl 后缀和 Stylus 语法关联。装完插件后必须手动触发一次绑定:
- 右键编辑器空白处 →
Set Syntax→Stylus(注意选Stylus,不是Stylus (Deprecated)) - 或按
Ctrl+Shift+P→ 输入Set Syntax: Stylus回车 - 检查右下角状态栏是否显示
Stylus,不是Plain Text或CSS - 如果
Set Syntax: Stylus命令根本不出现在命令面板里,说明插件未加载:去Preferences → Package Control → Disable Package确认Stylus没被禁用;若已禁用,重启后重装
保存 .styl 文件不自动生成 .css?必须配 compileOnSave 和全局 stylus 命令
Stylus 插件默认关闭编译功能,且依赖系统级 CLI 工具,不是纯前端逻辑:
- 终端执行
npm install -g stylus,再运行stylus --version验证是否输出版本号 - 打开
Preferences → Package Settings → Stylus → Settings – User - 填入最小可用配置(路径按项目结构调整):
{ "compileOnSave": true, "compress": false, "compileDir": "css", "compilePaths": { "": "css/" } } -
"compileOnSave": true是开关,不设就等于没开编译 -
"compilePaths"是对象,不支持通配符;想编译整个src/stylus/目录,得逐个写死映射,或改用构建系统替代
CSS 属性补全不弹出?原生机制需手动激活冒号后触发
Sublime 默认不会在 display: 这类位置弹出值提示,必须显式配置触发条件:
- 打开
Preferences → Settings – User - 确保含以下三项:
"auto_complete": true, "auto_complete_selector": "source.css -comment", "auto_complete_triggers": [{"selector": "source.css", "characters": ":"}] -
"auto_complete_selector"必须排除注释(-comment),否则在/* */里也会误触发 - 新建一个
.css文件,右下角确认语法显示为CSS,否则补全逻辑压根不加载 - 如需现代属性(如
gap、aspect-ratio),建议额外安装CSS3插件
Vue 单文件中 <style lang="stylus"></style> 仍无高亮?这是另一套机制
Stylus 插件只处理独立 .styl 文件,对 Vue 内联块完全无效。高亮和编译要分开解决:
- 装
Vue Syntax Highlight插件,并确保它启用了stylus子语法支持 - 检查插件加载顺序:
Vue Syntax Highlight必须优先于 Sublime 自带的HTML插件,否则会被覆盖 -
<style lang="stylus"></style>内的内容不会被Stylus插件编译,实时预览靠开发服务器(Vite/HMR),不是靠 Sublime - 若同时用 Webpack/Vite,建议关掉
compileOnSave,避免和构建工具冲突导致样式重复注入或路径错乱
最容易被忽略的是:Stylus 插件的 compilePaths 映射必须是字符串键值对,不能是数组;而 Vue 的高亮依赖另一个插件的子语法启用状态,不是靠改 Stylus 设置就能解决。这两件事表面相似,底层完全无关。











