根本原因是请求头缺失或编码不匹配:post未声明content-type: application/json导致后端无法解析中文字段,url含中文未encodeuricomponent引发非法字符,响应头缺失charset=utf-8造成乱码。

REST Client 发送请求时中文乱码或 400 错误
根本原因不是插件问题,而是请求头缺失或编码不匹配。比如 POST 时没加 content-type: application/json,后端可能拒绝解析中文字段;或者 URL 中含中文但没做 encodeURIComponent 处理,导致服务端收到非法字符。
实操建议:
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 所有 JSON 请求必须显式声明
content-type: application/json,哪怕看起来“应该默认” - URL 中含中文参数时,手动用
encodeURIComponent()编码后再填入.http文件,不要依赖插件自动处理 - 响应体出现方块或问号,检查返回头是否含
content-type: text/plain; charset=utf-8,否则在插件设置里加"rest-client.defaultCharset": "utf-8"
Live Server 启动后页面不刷新或 404
常见于项目结构非标准或路径配置偏差。Live Server 默认只 serve 当前打开文件所在目录,不会自动识别 dist 或 build 目录,也不支持 Vue/React 的 history 模式路由 fallback。
实操建议:
- 确保你点击
Go Live时,当前活动标签页是项目根目录下的index.html,而不是子目录里的某个 HTML - 需要代理 API 或支持前端路由时,在
.vscode/settings.json中加:"liveServer.settings.CustomBrowser": "chrome"和"liveServer.settings.AdvanceCustomBrowserCmdLineArgs": "--disable-web-security"(仅开发用) - 若用 Vite 或 Webpack Dev Server,别硬套 Live Server——它不是替代品,只是静态文件服务器
Volar + Vue 3 组件跳转失效
不是插件没装,而是 TypeScript 类型服务没对齐。Volar 需要和项目中 typescript 版本、vue-tsc、以及 tsconfig.json 中的 "compilerOptions.moduleResolution" 协同工作。任意一环错位,就会表现为 @/components/xxx 点不动、defineProps 类型推导失败。
实操建议:
- 确认项目根目录有
tsconfig.json,且含"vueCompilerOptions": { "target": 3 } - 运行
npx vue-tsc --noEmit看是否报类型错误,有则先修复 TS 层问题 - VSCode 设置里关掉旧插件
Vetur,它和 Volar 冲突;同时启用"typescript.preferences.includePackageJsonAutoImports": "auto"
ESLint + Prettier 保存后格式越修越错
典型症状是保存一次,引号从单引号变双引号,再保存又变回去,或分号忽有忽无。这不是插件 bug,而是 ESLint 规则和 Prettier 规则在 editor.formatOnSave 和 eslint.format.enable 两个开关下打架。
实操建议:
- 只留一个格式化入口:设
"editor.defaultFormatter": "esbenp.prettier-vscode",并关掉eslint.format.enable - 在
.eslintrc.js里加extends: ["eslint:recommended", "prettier"],用eslint-config-prettier关闭所有和 Prettier 冲突的规则 - 如果团队用 husky + lint-staged,确保 pre-commit hook 执行的是
eslint --fix而不是prettier --write,避免重复格式化
tsconfig.json 或改错 eslint.config.js 的导出方式,再强的插件也救不回跳转和提示。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










