Yarn安装失败或yarn --version报错的根本原因是Yarn未安装或未加入PATH；HTML项目中yarn init不生成依赖需手动yarn add；yarn run dev失败因package.json缺scripts.dev；yarn install在CI中卡住常因网络策略或lockfile版本混用。
Yarn 安装失败或 yarn --version 报错找不到命令
根本原因通常是 node.js 已安装但 yarn 本身没装，或者装了但没进系统 path。全局安装 yarn 的推荐方式不是 npm install -g yarn（容易权限冲突或版本错乱），而是用官方推荐的包管理器安装路径。
- macOS：用
brew install yarn（确保已装 Homebrew） - Windows：用
choco install yarn（需先装 Chocolatey），或直接下载.msi安装包（官网提供，PATH 自动配置） - Linux（Debian/Ubuntu）：添加官方源后运行
sudo apt install yarn，别用npm装
验证是否生效：新开终端，运行 yarn --version。如果仍报错，检查终端是否重启（尤其是 Windows 的 CMD/PowerShell）——旧会话不会自动加载新 PATH。
HTML 项目里运行 yarn init 后没生成 package.json 或依赖不生效
yarn init 只创建基础 package.json，它本身不装任何依赖。很多 HTML 开发者误以为“初始化”就等于“准备好开发环境”，其实只是第一步。
- 必须手动运行
yarn add --dev parcel（或其他构建工具），否则连本地服务器都起不来 - 如果项目已有
node_modules但yarn install不触发重装，先删掉node_modules和yarn.lock，再重跑yarn install - 注意
yarn install默认只装dependencies和devDependencies，不会执行postinstall脚本——除非你明确加--ignore-scripts false
常见现象：双击 index.html 打开空白页，控制台报 Failed to load module script —— 这说明没走打包流程，纯静态打开无法解析 import 语法。
在 HTML 项目中用 yarn run dev 启动失败，提示 Command not found
这个错误不是 Yarn 问题，而是 package.json 里没定义 scripts.dev 字段。Yarn 不会自动猜测你要用什么命令启动服务。
本文档主要讲述的是Eclipse配置Tomcat教程；Eclipse IDE： eclipse IDE 用作 JSP 页面和 Java 文件的开发环境。Eclipse 是一个非常简单易用的 IDE 环境，它具有很多特性，可以帮助程序员快速编写并调试 Java 程序。加上 tomcat 插件之后，这个 IDE 就是管理整个 Web 项目（包括 HTML 和 JSP 页面、图标和 servlet）的一个非常优秀的工具。 Tomcat： 驱动 JSP 页面需要使用 Tomcat。Tomcat 引擎是非常好的一个
立即学习“前端免费学习笔记（深入）”；
- 必须编辑
package.json，在scripts下加一行："dev": "parcel serve index.html"（假设你用 Parcel） - 不同工具命令不同：
"dev": "vite"、"dev": "webpack serve"，不能混用 - 如果脚本里用了
cross-env或concurrently，要先yarn add --dev cross-env concurrently，否则yarn run找不到这些二进制
顺带一提：yarn run 是安全的，它只在当前项目 node_modules/.bin 下找命令，不会污染全局；而直接敲 parcel serve 依赖全局安装，容易版本打架。
为什么 yarn install 比 npm install 快，但在某些 CI 环境反而卡住？
Yarn 默认启用离线镜像缓存和并行下载，本地开发确实快；但它对网络策略更敏感，尤其在企业内网或 CI 中禁用了 HTTPS 重定向、或镜像源被墙时，会卡在 Resolving packages... 阶段不动。
- 临时解决：运行
yarn config set strict-ssl false（仅限可信内网） - 长期方案：在项目根目录加
.yarnrc.yml，指定国内镜像：registry: "https://registry.npmmirror.com/" - CI 场景下，
yarn install --frozen-lockfile能避免意外升级，但前提是yarn.lock已提交且与当前package.json一致
真正容易被忽略的是 lockfile 版本：Yarn 1.x 用 yarn.lock，Yarn 3+ 默认用 .yarn/releases/yarn-X.X.X.cjs + .yarnrc.yml，混用会导致安装行为完全不可预测。
