Element Plus 开发调试时如何用 pnpm link 链接本地构建的依赖？
【免费下载链接】element-plus🎉 A Vue.js 3 UI Library made by Element team项目地址: https://gitcode.com/GitHub_Trending/el/element-plus
如果你正在本地开发 Element Plus 源码仓库（修改组件、修 bug、补充功能），并希望自己的业务项目直接引用本地构建出来的 Element Plus，而不是 npm 上发布的版本，官方开发 FAQ（dev-faq 的 “Link local dependencies” 一节）给出的标准做法是：先在 Element Plus 仓库里执行pnpm build生成 dist 产物，把该产物注册到 pnpm 的全局node_modules，最后在你的目标项目里用pnpm link --global element-plus完成链接。整条路径要求你的环境由 pnpm 管理，命令按 FAQ 给出的顺序执行。
准备条件
按 CONTRIBUTING.md 的 Prerequisites 一节，本地开发 Element Plus 需要：
- Node.js >= 22.13.0（仓库说明部分编译产物依赖 Node.js >= 22.13.0 的特性，所以需要该版本或更新版本）；
- pnpm >= 11（根目录 package.json 中声明了
"packageManager": "pnpm@11.24.0"，engines 要求node >= 22.13.0）； - Git > 2.20。
Element Plus 仓库是 pnpm workspace monorepo（见 AGENTS.md）。在 Element Plus 仓库根目录安装依赖：
pnpm install构建本地包
pnpm buildCONTRIBUTING.md 说明这条命令会编译将要发布到 npm 的代码。构建产物输出到仓库根目录的dist/（dist是生成的输出目录，AGENTS.md 明确提示不要手工编辑其中文件）。FAQ 的下一步就是要进入dist/element-plus，所以构建必须成功完成后才能继续。
把本地构建注册到全局 node_modules
在 Element Plus 仓库根目录下依次执行：
cd dist/element-plus # set cur element-plus to global `node_modules` pnpm link --global # for esm we also need link element-plus for dist pnpm link --global element-plus- 第一条
pnpm link --global把当前这个 element-plus 构建目录注册到 pnpm 的全局node_modules； - 第二条
pnpm link --global element-plus是 FAQ 针对 ESM 场景额外要求的一步，把 dist 内部的element-plus包名一并链接。
命令注释直接来自官方 FAQ 原文，保留以说明每一步的作用。
在目标项目中链接 element-plus
回到你自己的、依赖element-plus的项目目录（下面用your-project指代，替换为你项目的实际路径）：
cd your-project pnpm link --global element-plus这一步让目标项目把element-plus解析到刚才注册的全局链接，也就是你本地的构建产物。FAQ 同时提示，pnpm link的更多用法见 pnpm 官方文档的 link 命令说明。
验证与排查
- 上述每条命令都应无报错地完成。如果目标项目里的
pnpm link --global element-plus执行失败，先回到 Element Plus 仓库核对 FAQ 中步骤是否已按顺序执行过：pnpm build、cd dist/element-plus、两条pnpm link --global。 - 链接指向的是本地
dist/element-plus目录，它由源码构建而来。修改本地源码后，需要重新执行pnpm build刷新产物，目标项目才能用到新的构建结果；不要手工改动dist里的文件。 - 开发 Element Plus 仓库时如果遇到依赖相关问题，官方 FAQ 给出的处理方式是（仅在 Element Plus 仓库根目录执行）：
rm -rf node_modules pnpm i这里rm -rf node_modules会删除 Element Plus 仓库自身的依赖目录并随后重新安装，只影响该仓库，不会改动你链接目标项目的内容；执行前请确认当前目录是 Element Plus 仓库根目录。
相关资料
- docs/en-US/guide/dev-faq.md：Link local dependencies 与依赖问题处理原文
- CONTRIBUTING.md：环境要求与
pnpm install/pnpm build说明 - AGENTS.md：仓库结构与常用命令（含
dist输出目录约定） - package.json：
packageManager、engines 与 build 脚本定义
【免费下载链接】element-plus🎉 A Vue.js 3 UI Library made by Element team项目地址: https://gitcode.com/GitHub_Trending/el/element-plus
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
