GoLand不内置Vite，需通过package.json的npm脚本运行；常见问题包括vite命令未找到、热更新失效、调试依赖浏览器DevTools而非IDE。
GoLand 里 Vite 不是内置构建工具，得靠 npm 脚本触发
GoLand 本身不直接“配置 Vite”作为 IDE 内置构建器，它只是识别 vite 命令并提供运行/调试支持。真正起作用的是项目根目录下的 package.json 中定义的 scripts，比如 "dev": "vite" 或 "build": "vite build"。IDE 的角色是调用这些脚本，而不是替代它们。
常见错误现象：
- 点击绿色三角运行时提示
Command 'vite' not found - 右键
vite.config.ts没有“Run”选项 - 修改 HTML/JS 后刷新浏览器没反应（热更新失效）
实操建议：
- 确认项目已执行过
npm install或yarn install，且node_modules/.bin/vite存在 - 在 GoLand 中打开
package.json，找到dev脚本，右键 →Run 'npm run dev'（不是双击文件） - 首次运行后，GoLand 会自动在
Run Configurations中保存该脚本配置，后续可直接从顶部工具栏下拉选择 - 若使用 TypeScript，确保
vite.config.ts与项目根目录的tsconfig.json兼容，否则vite启动可能报错Cannot find module 'vite'（实际是类型解析失败）
静态文件预览别依赖 GoLand 内置服务器，用 Vite 自带 dev server
GoLand 的 Open in Browser 或 Preview 功能只适用于纯静态 HTML，对需要模块解析、路径重写、环境变量注入的 Vite 项目完全无效——它不会启动开发服务器，也不处理 /@vite/client 等注入逻辑。
正确做法是让 Vite 启动真正的 dev server（默认 http://localhost:5173），然后手动或自动打开浏览器：
- 运行
npm run dev后，GoLand 控制台会输出类似✓ Local: http://localhost:5173/的地址，点击即可跳转 - 可在 Run Configuration 中勾选
After launch: Open browser，填入http://localhost:5173（注意端口需与vite.config.ts中server.port一致） - 如果项目用了
base: '/my-app/'，浏览器必须访问http://localhost:5173/my-app/，否则资源 404 —— 这个路径不会被 GoLand 自动推导
vite.config.ts 修改后需重启 dev server，GoLand 不会热重载配置
Vite 的配置文件变更（如改了 resolve.alias 或 server.proxy）不会被正在运行的 dev server 捕获，必须手动重启。GoLand 不提供“重载 vite 配置”的按钮或快捷键。
容易忽略的点：
- 仅保存
vite.config.ts文件 ≠ 配置生效；必须终止当前进程再重新运行npm run dev - 若启用了 GoLand 的
Build project automatically（Settings → Tools → Actions on Save），它对 Vite 配置无任何影响 - 在
vite.config.ts中使用defineConfig是为了类型提示，但 Vite 实际只读取export default { ... }对象，拼写错误或语法问题会导致启动失败，错误信息会直接打印在 GoLand 的Run窗口里，例如error when starting dev server: TypeError: Cannot read property 'map' of undefined
调试 HTML/CSS/JS 时，断点要打在浏览器 DevTools，不是 GoLand
GoLand 对前端代码的调试支持有限：它能识别 debugger 语句并高亮，但无法单步执行浏览器中的 JS，也不能查看 DOM 变化或 CSS 计算值。Vite dev server 输出的是经转换后的代码（含 sourcemap），但 GoLand 不主动加载这些 map 文件用于调试。
真实工作流是：
- 在 GoLand 中编辑
src/main.ts或index.html，保存 - 浏览器自动刷新（HMR 生效），按
F12打开 DevTools - 在
Sources面板中找到原始 TS/JS 文件（通常在webpack://或vite://协议下），设断点、查看console、检查元素 - GoLand 唯一能辅助的是：右键 HTML 文件 →
Debug 'index.html'仅适用于无构建步骤的纯静态页，对 Vite 项目会失败并提示No debug configuration for this file type
复杂点在于 sourcemap 路径映射是否准确——如果 vite.config.ts 中 build.sourcemap 关闭，或 server.sourcemapIgnoreList 过滤了关键文件，DevTools 就找不到原始代码行。这个细节几乎没人检查，但它是调试失败最常见原因。
