VSCode Remote - SSH插件下Prettier保存自动格式化失效求助

开发者阿泽

2026-7-19

解决方案：Remote-SSH 下 Prettier 自动格式化失效

常见原因及修复步骤

检查远程环境的 Prettier 安装
本地的 Prettier 依赖只作用于本地，远程服务器可能未安装对应版本。在远程终端执行 npm list prettier（检查项目依赖）或 prettier --version（检查全局安装）确认状态。若未安装，在远程项目目录执行 npm install prettier --save-dev（项目级安装），或 npm install -g prettier（全局安装）。
确认远程 VS Code 的格式化配置
远程环境的 VS Code 配置独立于本地，按 Ctrl+, 打开远程设置（界面会标注 Remote [SSH: xxx]），确保以下配置正确：
```
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
```
排查工作区配置冲突
项目根目录的 .vscode/settings.json 可能覆盖全局配置，打开该文件检查是否存在禁用自动格式化或指定其他工具的配置，比如：
```
"editor.formatOnSave": false,
"[typescript]": {
  "editor.defaultFormatter": "other.formatter.id"
}
```
若有此类配置，删除或修改为 Prettier 相关设置。
重启远程 VS Code 服务
插件加载异常可能导致功能失效，按 Ctrl+Shift+P 执行 Remote-SSH: Kill VS Code Server on Host，重新连接远程后测试保存格式化。
确认远程 Prettier 插件状态
打开远程 VS Code 的插件面板，查看 Prettier - Code formatter 插件是否显示 Installed remotely 且处于启用状态。若未启用，点击启用按钮后重启远程窗口。
修复文件类型关联
部分文件类型可能未关联 Prettier，可在远程设置中针对特定类型单独配置：
```
"[vue]": {
  "editor.defaultFormatter": "esbenp.prettier-vscode"
}
```