求助：GitHub主分支Excalidraw独立JS文件构建步骤（Yarn构建失败）

1. 确认环境依赖 #

• 先装Node.js（推荐LTS版本，比如18.x或20.x），Yarn需要Node环境支持
• 验证Node和npm可用：

  node -v
  npm -v
  

2. 安装正确版本的Yarn #

Excalidraw用的是Yarn Berry（v2+），别装旧版Yarn Classic：

npm install -g yarn

装完验证版本：

yarn -v

3. 进入项目目录 #

你已经从master分支下载了代码，直接进入项目根目录：

cd excalidraw

4. 安装项目依赖 #

执行命令装全依赖，网络不稳的话可能要多试几次：

yarn install

如果装依赖时报错，先删缓存再重装：

rm -rf node_modules .yarn/cache
yarn install --force

5. 构建独立JS文件 #

用项目自带的构建命令生成单包：

yarn build:library

构建完成后，独立JS文件会出现在dist目录里，一般有两个版本：excalidraw.min.js（压缩版）和excalidraw.js（未压缩版）。

6. 验证构建结果 #

可以写个简单的HTML测试：

<!DOCTYPE html>
<html>
<body>
  <div id="app"></div>
  <script src="./dist/excalidraw.min.js"></script>
  <script>
    Excalidraw.mount(document.getElementById('app'));
  </script>
</body>
</html>

打开这个HTML文件，能正常加载Excalidraw编辑器就说明成了。

常见问题排查 #

• 构建时报“找不到模块”：检查是不是在项目根目录执行命令，或者重新装一遍依赖
• Yarn版本不兼容：执行yarn set version berry切换到Yarn Berry，再重装依赖
• 依赖装不上：换国内镜像源试试

  yarn config set registry https://registry.npmmirror.com
  

内容的提问来源于stack exchange，提问作者Chandu