Element Plus 本地文档站 10 分钟跑起离线文档【免费下载链接】element-plus A Vue.js 3 UI Library made by Element team项目地址: https://gitcode.com/GitHub_Trending/el/element-plus这篇教程讲怎么在本地跑起 Element Plus 官方文档站。克隆仓库、装依赖、启动命令三条搞定浏览器打开 http://localhost:2000 就是完整文档站组件演示、API 表格、主题介绍页全在断网也能查。全程约 10 分钟。 环境要求与前置检查命令检查项要求检查命令Node.js 22.13.0node -vpnpm11.24.0以根目录 package.json 为准pnpm -v端口 2000空闲dev 服务默认使用lsof -i :2000网络能访问 npm registrypnpm config get registrypnpm 未安装或版本对不上时用 corepack 激活corepack enable corepack prepare pnpm11.24.0 --activateNode 低于 22.13 就先升级后面所有命令都依赖它。 主流程3 步跑通本地文档站一键拉取克隆 Element Plus 仓库git clone https://gitcode.com/GitHub_Trending/el/element-plus cd element-plus执行完ls能看到docs/和packages/两个目录就算成了文档站内容全在 docs/ 里。 避坑这是 pnpm 多包仓库后面的安装、启动都必须在根目录执行别进子目录。运行 pnpm install 装好全部依赖pnpm installpostinstall 会自动生成组件 stub这一步属于正常输出。 终端以Done结尾且node_modules/出现就对了。首次安装较慢别中途打断。 避坑下载中途断了直接重跑即可pnpm 会续上。运行 pnpm docs:dev 启动本地文档站pnpm docs:dev这条命令会先生成本地 i18n 语言包再起 VitePress。 此时终端应出现Local: http://localhost:2000/。 浏览器打开页面能看到文档首页和组件演示区就算成了。端口和网卡配置见 docs/.vitepress/config/vite.ts固定 2000 端口host 绑定所有网卡。同一局域网的同事也能直接访问适合当内网文档服务。 可选构建纯静态离线版什么时候才需要想把文档挂成长期内网服务或者希望页面不受源码热更新影响。pnpm docs:build pnpm docs:servebuild 产出静态文件serve 在 5001 端口托管。 打开 http://localhost:5001/ 页面与 dev 模式一致即成功。 常见问题速查现象pnpm install报 engines 不满足。原因Node 低于 22.13.0。处理升级 Node 到 22.13 以上再重装。现象安装中途报错、缺模块。原因node_modules 不完整。处理删掉 node_modules 重新pnpm install官方 FAQ 也是这么给的见 docs/en-US/guide/dev-faq.md。现象pnpm docs:dev报 Port 2000 is already in use。原因别的进程占着 2000。处理lsof -i :2000找到占用进程结束它再启动。现象pnpm -v显示的不是 11.24.0。原因包管理器版本旧。处理重跑corepack prepare pnpm11.24.0 --activate。想改组件而不只是看文档下一步读 docs/en-US/guide/dev-guide.md。里面讲了 play 项目与组件模板生成命令装好依赖后pnpm dev即可开跑。【免费下载链接】element-plus A Vue.js 3 UI Library made by Element team项目地址: https://gitcode.com/GitHub_Trending/el/element-plus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考