夜雨聆风如果你写过 Unity 插件，大概率遇到过这个问题：插件写好了，怎么在项目之间共享？传统的做法是导出 Unity Package 文件，然后手动导入到每个项目里。项目少的时候还好，项目一多，版本一多，管理起来就头疼了。
其实 Unity 早就提供了一个更优雅的方案——Package Manager。你平时用的 URP、Textmesh Pro 都是通过它安装的。那能不能自己也搭一个私有服务器，把写的插件像 URP 一样一键安装呢？答案是可以的，而且没有想象中那么复杂。
这篇文章就把整个搭建过程记录下来，从买服务器到最终能在 Unity 里一键安装自己写的插件，一步步来。
先说方案选型
Unity Package Manager 底层用的是 npm 的协议规范。所以我们需要一个 npm 私服来充当 Package 仓库。开源方案里最成熟的就是 Verdaccio，轻量、配置简单、社区活跃，用它就对了。
整体思路就是：买一台云服务器 → 装 Verdaccio → 把插件发布上去 → 在 Unity 里配置服务器地址 → 搞定。听起来不复杂对吧？实际上确实不复杂，主要是一些细节需要注意。
服务器部署
服务器随便选，阿里云、腾讯云都行，系统用 Ubuntu 就好。我用的腾讯云轻量级服务器，性价比还可以。
买好之后进控制台，用网页终端直接登录。登录之后先切到 root 权限：
sudo -i
接下来安装 Node.js 和 npm，Verdaccio 依赖它们运行：
curl -sL https://deb.nodesource.com/setup_11.x | bash -
apt-get install -y nodejs
装完之后验证一下：
nodejs -v
npm -v
能输出版本号就说明没问题。然后安装 Verdaccio：
npm install --global verdaccio
安装完成后，先别急着运行。需要先改一下配置文件，把监听端口设成你想要的值。运行一次 verdaccio，它会输出 config file 的路径，记下来。然后 Ctrl Z 退出，用 vim 打开那个配置文件：
vim /home/你的用户名/verdaccio/config.yaml
在 plugins 下面加两行配置，指定监听端口（比如 4873）：
改完保存退出（vim 里按 i 编辑，按 Esc 退出编辑，输入 :wq 保存退出）。然后记得去云服务器的防火墙里把你设置的端口开放，不然外面访问不到。
现在重新运行 verdaccio，浏览器打开 http://你的服务器IP:4873 就能看到 Verdaccio 的管理界面了：
到这里服务器基本就搭好了。但有一个问题：直接在终端运行 verdaccio 的话，关掉终端它就停了。我们需要用 screen 来让它在后台持续运行：
sudo apt-get install screen
screen
verdaccio
按 Ctrl A 然后按 D 就能退出 screen，verdaccio 会继续在后台跑。以后想重新进入看日志，输入 screen -r 就行。
准备你的插件包
服务器搭好了，接下来要把插件打包成 Unity 能识别的 Package 格式。这个格式其实不复杂，但有几个关键点必须注意。
首先，Package 是以文件夹形式管理的，根目录必须有一个 package.json 文件。这个文件里要填包名、版本号、描述、依赖的其他包等信息。包名建议用反向域名格式，比如 com.yourname.yourplugin，这样不容易跟别人的包冲突。
其次，脚本要按 Editor 和 Runtime 分类放。Editor 下的脚本只在编辑器环境生效，Runtime 下的才是运行时需要的。这个区分很重要，不然打包的时候可能会出问题。
然后，每个有脚本的文件夹都需要创建一个 Assembly Definition 文件（.asmdef）。这个文件的作用是把同一文件夹下的脚本定义为一个程序集。Editor 的程序集要把平台设为 Editor Only，并且引用 Runtime 的程序集（因为 Editor 脚本通常会用到 Runtime 的接口）。
如果你的插件还依赖了其他插件，也要在程序集引用里加上。这些细节如果漏掉了，发布之后安装的时候就会报各种奇怪的编译错误。
发布到服务器
插件包准备好了，接下来就是发布。打开 Windows PowerShell（系统自带的），按以下步骤操作：
先注册一个 Verdaccio 账号（只需要注册一次）：
npm adduser --registry http://你的服务器IP:4873
会提示你输入用户名、密码和邮箱。之后如果需要登录：
npm login --registry http://你的服务器IP:4873
然后 cd 到你的 Package 根目录（就是 package.json 所在的目录），执行发布：
npm publish --registry http://你的服务器IP:4873
发布成功后，刷新 Verdaccio 的网页就能看到你的包了。有一点要注意：每次更新发布都需要提升版本号，否则发布会失败。这个是 npm 的规范，不改版本号它认为你没有新内容。
在 Unity 里使用
包已经发布到服务器了，接下来让 Unity 能找到它。打开项目的 Packages 目录下的 manifest.json 文件：
在 dependencies 上方加一段 scopedRegistries 配置：
"scopedRegistries": [{"name": "My Server","url": "http://你的服务器IP:4873","scopes": ["com.yourname"]} ]
scopes 字段填你的包名前缀，这样 Unity 就知道去你的服务器找这个前缀的包了。保存之后回到 Unity 编辑器，等它刷新一下，打开 Package Manager 就能在 My Registry 里看到你的包了，直接点 Install 就行。
如果你希望每个新建的 Unity 项目都能直接安装你服务器上的包，不用每次都手动改 manifest.json，可以修改 Unity 编辑器的项目模板。找到 Unity 安装目录下的 Editor/Data/resources/templates/packages/mainfest.json 模板文件，把上面的 scopedRegistries 配置加进去，保存。不过这个文件是 .tgz 压缩包，改完之后需要用 PeaZip 重新压缩为 .tgz 格式替换原文件。这个操作有一定风险，建议先备份原文件。
一些实际使用中的体会
搭完这套流程之后，用了一段时间，有几个感受想分享给大家。
第一个是版本管理变得很方便。以前用 Unity Package 文件手动导入，版本全靠文件夹名来区分，很容易搞混。现在每次更新只需要改 package.json 里的版本号，重新 publish 一下，Unity 那边就能看到更新提示了。
第二个是团队协作更顺畅了。服务器搭好之后，团队里的其他人只需要在 manifest.json 里加一行配置，就能直接安装共享的插件，不用再传来传去了。
第三个是 Assembly Definition 一定要认真配。我一开始就是因为 Editor 的程序集没设好平台限制，导致打包的时候把编辑器代码也打进去了，报了一堆错。后来把 Editor 程序集的平台设为 Editor Only，引用关系也理清了，就顺畅了。
总的来说，搭一个私有 Package 服务器不算难，难的是插件包本身的规范化。把 package.json、Assembly Definition、Editor/Runtime 分离这些基础工作做好，后面的发布和使用就是水到渠成的事。
以上经验基于个人项目实践整理，希望能帮到有同样需求的同学。
