什么是Yarn
Yarn 是 Facebook 推出的一款 JavaScript 包管理工具,用来替代 npm。相比 npm,Yarn 安装依赖更快、更安全,特别是在团队协作开发中,能保证每个成员的依赖版本完全一致。
比如你和同事一起开发一个前端项目,他本地跑得好好的,你拉下代码却报错,大概率是依赖版本不一致。Yarn 通过 yarn.lock 文件锁定版本,避免这类“在我机器上是好的”问题。
安装Node.js和Yarn
Yarn 需要 Node.js 环境支持。先去官网下载并安装 Node.js(建议选择 LTS 版本),安装完成后打开终端,输入以下命令检查是否成功:
node -v
yarn -v如果你还没安装 Yarn,可以通过 npm 快速安装:
npm install -g yarn也可以使用 Homebrew(macOS)或 Chocolatey(Windows)等包管理器安装。
初始化项目
进入你的项目目录,运行下面命令初始化项目:
yarn init这个过程会引导你填写项目名称、版本、描述等信息,生成 package.json 文件。如果想跳过交互式提问,可以直接用:
yarn init -y添加和管理依赖
开发中常用的依赖分两类:生产依赖和开发依赖。比如 React 是生产依赖,而 Webpack 或 Babel 属于开发依赖。
安装生产依赖:
yarn add react react-dom安装开发依赖:
yarn add --dev webpack webpack-cli babel-loader移除某个包也很简单:
yarn remove react-dom使用yarn.lock保障一致性
每次执行 yarn add 或 yarn install,Yarn 都会生成或更新 yarn.lock 文件。这个文件记录了每个依赖的确切版本和来源,确保所有人在安装时拿到的都是相同的依赖树。
千万别把它删了,也别忽略它。你应该把它提交到 Git 仓库中。
脚本命令配置
在 package.json 中可以定义常用命令,比如启动开发服务器、打包构建等:
"scripts": {
"start": "webpack serve --mode development",
"build": "webpack --mode production",
"lint": "eslint src/"
}之后就可以用简洁命令运行:
yarn start
yarn build全局与缓存设置
Yarn 支持全局安装工具,例如你可以全局安装 Vue CLI:
yarn global add @vue/cli查看全局安装路径:
yarn global binYarn 还自带本地缓存机制,安装过的包会被缓存起来,下次安装更快。查看缓存列表:
yarn cache list清理缓存:
yarn cache clean常见问题处理
有时候执行 yarn install 卡住不动,可能是网络问题。可以尝试切换镜像源:
yarn config set registry https://registry.npmmirror.com这样使用国内镜像,安装速度明显提升。恢复官方源:
yarn config delete registry如果遇到权限问题,在 macOS 或 Linux 上可以加上 sudo,但更推荐通过配置 npm 的前缀来避免权限问题。