配置Sublime Text保存时自动格式化代码需安装JsPrettier插件并启用auto_format_on_save,确保Prettier已安装,设置排除目录及可选的项目级配置文件,保存文件触发自动格式化,检查控制台排查路径或权限问题。

1. 安装必要的插件
打开 Sublime Text,使用 Package Control 安装以下插件:
- JsPrettier:这是最常用的 Prettier 集成插件,支持多种前端语言(JavaScript、TypeScript、HTML、CSS、Vue 等)。
安装方法:
- 按下 Ctrl+Shift+P(Mac 上是 Cmd+Shift+P)打开命令面板。
- 输入 “Package Control: Install Package”,回车。
- 搜索 “JsPrettier”,点击安装。
2. 确保系统已安装 Prettier
JsPrettier 插件依赖本地的 prettier 命令。推荐全局或项目内安装:
- 全局安装:
npm install -g prettier - 项目内安装(推荐):
在项目根目录运行:npm install --save-dev prettier
插件会优先使用项目内的 Prettier,避免版本冲突。
3. 配置 JsPrettier 设置
进入插件设置:
- 菜单栏选择 Preferences > Package Settings > JsPrettier > Settings。
- 在右侧用户设置中添加或修改如下内容:
{
"auto_format_on_save": true,
"auto_format_on_save_excludes": [
"*/node_modules/*",
"*/dist/*",
"*/build/*"
],
"prettier_cli_path": "",
"node_path": "",
"format_on_save_timeout": 2000
}
- auto_format_on_save: true 是关键,开启保存时自动格式化。
- auto_format_on_save_excludes 可排除某些目录(如 node_modules)防止卡顿。
-
prettier_cli_path 一般留空,插件会自动查找。若报错可手动指定路径,如:
/usr/local/bin/prettier或C:\\Users\\xxx\\AppData\\Roaming\\npm\\prettier.cmd。 - node_path 同样可留空,除非 Sublime 找不到 Node。
4. (可选)项目级配置文件
在项目根目录创建 .prettierrc 文件来自定义格式规则:
{
"semi": false,
"singleQuote": true,
"trailingComma": "es5",
"printWidth": 80
}
也可使用 prettier.config.js 或 .prettierrc.json 等格式。插件会自动读取这些配置。
同时建议在项目中添加 .prettierignore 文件,忽略不需要格式化的文件:
node_modules dist build *.min.js
5. 测试是否生效
打开一个 JS 或 Vue 文件,故意写乱格式,例如:
function hello(){console.log("world");}
保存文件(Ctrl+S),如果自动变成:
function hello() {
console.log("world")
}
说明配置成功。
若未生效,检查控制台(View > Show Console)是否有错误提示,常见问题包括找不到 Prettier、Node 路径不对、权限问题等。
基本上就这些。只要插件装好、Prettier 存在、保存选项打开,Sublime 就能像 VS Code 一样自动格式化代码。关键是路径和配置别出错。










