sublime text 本身不内置 grunt 支持，必须依赖插件桥接，且前提是 grunt cli 已全局安装并可在终端执行 grunt --version；若失败，需先 npm install -g grunt-cli 并确认 node.js 和 path 配置正确，再安装 sublimegrunt 插件，确保项目根目录含有效 gruntfile.js，否则插件命令无法识别任务。
Sublime Text 本身不内置 Grunt 支持，必须靠插件桥接，而关键不是装哪个插件，而是 Grunt CLI 是否已全局可用——没它，插件根本跑不起来。
确认 Grunt CLI 已安装且可执行
插件只是调用命令行的壳子，grunt 命令必须在终端里能直接运行，否则所有 Sublime 插件都会报 'grunt' is not recognized 或类似错误。
- 在终端（CMD/PowerShell/Terminal）中执行
grunt --version，有输出版本号才算通过 - 如果报错，先全局安装：
npm install -g grunt-cli（注意不是grunt，是grunt-cli） - 确认 Node.js 和 npm 已正确配置 PATH；Windows 用户尤其要检查是否勾选了“将 npm 添加到 PATH”选项
- 重启 Sublime Text —— 它不会自动感知系统环境变量变更
安装 SublimeGrunt 插件并验证路径
SublimeGrunt 是最轻量、兼容性最好的 Grunt 集成插件，不依赖额外服务，只调用本地 grunt 命令。
- 用 Package Control 安装：
Ctrl+Shift+P→ 输入Install Package→ 搜索SublimeGrunt→ 回车 - 安装后无需重启，但需确保当前打开的文件夹是含
Gruntfile.js的项目根目录 - 按
Ctrl+Shift+P输入Grunt，应出现Grunt: Run Task、Grunt: Show Tasks等命令 - 若命令不出现，检查是否打开了正确的项目文件夹（不是单个文件），或
Gruntfile.js是否存在且语法无误
自定义构建任务时注意工作目录和参数传递
默认情况下，SublimeGrunt 在项目根目录执行 grunt，但某些任务需要指定 --gruntfile 或 --base 参数，硬编码进插件配置反而容易出错。
- 推荐做法：在项目根目录下新建
sublime-grunt.sublime-settings（放在Packages/User/下），内容为：{ "working_dir": "${project_path}", "gruntfile": "Gruntfile.js" } - 避免在设置里写死路径，用
${project_path}动态解析更可靠 - 想快捷运行特定任务（如
grunt watch），可绑定快捷键，但不要用shell_cmd直接拼接字符串——容易漏转义空格或特殊字符 - 真正稳定的方案是：用
Grunt: Run Task命令手动选，首次会缓存任务列表，后续可快速触发
常见失败场景与绕过方式
很多问题其实和插件无关，而是 Grunt 自身环境或项目结构导致的静默失败。
-
Grunt: Show Tasks返回空列表？先在终端里cd到项目根目录，运行grunt --help看是否识别任务；若不识别，说明Gruntfile.js有语法错误或require('load-grunt-tasks')失败 - 任务执行后立即退出，看不到日志？Sublime 默认隐藏 stdout/stderr，可在
SublimeGrunt设置里启用"show_output": true - Windows 下中文路径报错？Grunt CLI 对非 ASCII 路径支持不稳定，临时解法：把项目移到纯英文路径（如
C:\dev\myproject） - 不想装插件？直接用 Sublime 的 Build System：新建
Grunt.sublime-build，内容为{"shell_cmd": "grunt $1", "working_dir": "${project_path}"}，然后Ctrl+B调用
Grunt 流程集成真正的门槛不在插件安装，而在 CLI 环境是否干净、Gruntfile.js 是否能被原生 CLI 正确加载——插件只是镜子，照出的是你本地 Grunt 环境的真实状态。
