AntSword 是安装个开源的跨平台网站管理工具，说白了就是教程中国版的“菜刀”。它用 Node.js 和 Electron 写成，安装界面比老菜刀顺眼不少，教程插件生态也活跃。安装下面直接进安装流程，教程不废话。安装

先装 Node.js，教程版本别太低

AntSword 跑在 Electron 上，安装Electron 又依赖 Node.js。教程所以第一步是安装去 nodejs.org 下载 LTS 版本。我建议用 14.x 或 16.x，教程太新的安装版本有时候跟 Electron 的构建工具打架。Windows 用户直接下 .msi 安装包，教程一路下一步就行。安装macOS 用 Homebrew 的话一条命令：brew install node。装完在终端敲 node -v，能看到版本号就说明成了。

有个坑得提一下：如果你之前装过老版本的 Node，最好先卸干净。我见过有人同时存在两个 Node 版本，npm 指向的路径乱七八糟，后面装 AntSword 依赖时各种报错，折腾半天才发现是环境变量的问题。

下载 AntSword 源码

官方 GitHub 仓库是 github.com/AntSwordProject/antSword。直接 clone 或者下 zip 包都行。我习惯用 git：

git clone https://github.com/AntSwordProject/antSword.git

下完进入目录，你会看到 package.json、source 文件夹、modules 文件夹这些。别急着双击什么 exe，源码版没有现成的可执行文件，得自己构建。

安装依赖，网络是关键

在 AntSword 根目录下执行：

npm install

这一步最耗时，也最容易出问题。Electron 的二进制包要从 GitHub 下载，国内网络大概率卡住或者直接超时。解决办法是换淘宝镜像：

npm config set registry https://registry.npmmirror.com npm config set ELECTRON_MIRROR https://npmmirror.com/mirrors/electron/

设完再跑 npm install，速度会快很多。如果还是报错，试试删掉 node_modules 文件夹和 package-lock.json 重新来。我那次装的时候卡在 electron-builder 的 postinstall 脚本上，后来加了 --ignore-scripts 参数先跳过，再单独补装才过。

启动与打包

依赖装完后，开发模式启动：

npm start

窗口弹出来就说明成了。界面左侧是 Shell 管理，右侧是文件管理、数据库操作这些。第一次用的话，点左上角“添加数据”，选 PHP、ASP、ASPX 或者 JSP，填 URL、密码、编码器，跟菜刀一个逻辑。

如果你想打包成独立可执行文件，用：

npm run build

产物在 dist 文件夹里。Windows 下是 exe，macOS 是 dmg。打包过程同样依赖网络下载 Electron 的预编译包，镜像没配好的话照样卡。

几个实际会遇到的问题

Windows 上如果提示 node-gyp 相关错误，装个 windows-build-tools 就行：npm install -g windows-build-tools。macOS 上如果报 Python 版本问题，确认一下 python 命令指向的是 Python 2.7 还是 3.x，Electron 的某些构建脚本对 Python 版本敏感。

还有，AntSword 的插件系统需要单独下载。官方插件仓库在 github.com/AntSwordProject/AntSword-Loader，但那是给旧版用的。新版直接在设置里配置插件源，或者手动把插件文件夹丢进 antSword/antSword-data/plugins 下面。

装完之后别急着连目标。先在本地搭个 PHP 环境测试一下，确认编码器和马儿能正常通信。我见过太多人装完工具直接上生产环境，结果编码器选错，传上去的文件全是乱码，回头还得清理。

AntSword 的更新频率不算高，但社区一直有人维护。遇到问题先去 GitHub Issues 搜，大部分坑都有人踩过。实在搞不定，加官方 QQ 群问，比自己在那里瞎折腾快得多。