Vite Yarn 常见报错

这篇内容是在有道云旧笔记基础上重新整理的 Vue/Vite 工程实践 笔记。原始记录偏碎片化，这里补充了使用场景、阅读顺序和落地时需要注意的边界，方便以后在项目里快速复用。

适用场景 ​

• Vue/Vite 项目中遇到配置、组件封装、构建或运行时问题时，作为排查入口。
• 需要把一次性调试经验沉淀成团队内可复用的前端工程实践。
• 迁移旧项目或升级依赖时，用来对照检查环境变量、插件和组件行为差异。

核心要点 ​

• 正文以代码或命令片段为主，阅读时建议先确认目标问题，再挑选对应片段验证。
• 保留了 3 段可直接参考的代码或命令，主要涉及 javascript，复制前需要按当前项目路径、版本和变量名做调整。
• 文中保留了 1 个导出图片资源，适合和文字步骤一起对照查看。

$ vite
failed to load config from D:\lancema\workspace\vite\thinks-rxvts\vite.config.ts
error when starting dev server:
Error: The package "esbuild-windows-64" could not be found, and is needed by esbuild.

If you are installing esbuild with npm, make sure that you don't specify the
"--no-optional" flag. The "optionalDependencies" package.json feature is used
by esbuild to install the correct binary executable for your current platform.
    at generateBinPath (D:\lancema\workspace\vite\thinks-rxvts\node_modules\esbuild\lib\main.js:1643:15)
    at esbuildCommandAndArgs (D:\lancema\workspace\vite\thinks-rxvts\node_modules\esbuild\lib\main.js:1699:11)
    at ensureServiceIsRunning (D:\lancema\workspace\vite\thinks-rxvts\node_modules\esbuild\lib\main.js:1856:25)
    at Object.build (D:\lancema\workspace\vite\thinks-rxvts\node_modules\esbuild\lib\main.js:1749:26)
    at bundleConfigFile (D:\lancema\workspace\vite\thinks-rxvts\node_modules\vite\dist\node\chunks\dep-85dbaaa7.js:68658:34)
    at loadConfigFromFile (D:\lancema\workspace\vite\thinks-rxvts\node_modules\vite\dist\node\chunks\dep-85dbaaa7.js:68635:35)
    at resolveConfig (D:\lancema\workspace\vite\thinks-rxvts\node_modules\vite\dist\node\chunks\dep-85dbaaa7.js:68185:34)
    at createServer (D:\lancema\workspace\vite\thinks-rxvts\node_modules\vite\dist\node\chunks\dep-85dbaaa7.js:66699:26)
    at CAC.<anonymous> (D:\lancema\workspace\vite\thinks-rxvts\node_modules\vite\dist\node\cli.js:687:30)
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

解决办法

node ./node_modules/esbuild/install.js

实践检查清单 ​

• 先确认 Vue、Vite、Node、包管理器版本，再判断示例是否需要按当前工程结构调整。
• 涉及构建或插件配置时，建议同时验证开发环境和生产构建结果。
• 涉及 UI 或浏览器行为时，至少在桌面端和移动端各验证一次关键路径。
• 涉及接口、服务端或权限逻辑时，补充失败分支和权限边界测试。

复盘小结 ​

这篇笔记更适合作为问题排查或方案落地前的速查材料。后续如果在真实项目中再次遇到同类问题，可以继续把具体版本、报错信息、最终取舍和验证结果补到对应小节里，让它从代码片段逐步沉淀成完整方案。