如何将VS中Node.js项目部署到本地并在无Node.js/NPM的客户端运行？

针对你的需求，有几种成熟的工具可以把Node.js项目打包成独立可执行文件，将Node.js运行时、项目代码和依赖全部封装进去，客户端服务器直接运行文件即可，无需额外安装环境：

1. 使用pkg打包成单可执行文件 #

pkg是目前最常用的Node.js项目打包工具，支持跨平台生成可执行文件。

• 操作步骤：
  • 在你的开发环境全局安装pkg：npm install -g pkg
  • 在项目根目录的package.json中配置入口文件（假设你的项目入口是index.js）：

    {
      "bin": "./index.js"
    }
    

  • 执行打包命令，指定目标平台：
    • Windows平台：pkg . --targets win-x64
    • Linux平台：pkg . --targets linux-x64
    • macOS平台：pkg . --targets macos-x64
  • 打包完成后，项目根目录会生成对应平台的可执行文件，直接复制到客户端服务器双击或通过命令行启动即可。
• 注意：如果项目包含动态加载的资源文件（如静态页面、配置文件）或原生模块，需要在package.json中添加pkg字段声明要打包的资源：

  {
    "pkg": {
      "assets": ["public/**/*", "config/*.json"]
    }
  }
  

2. 使用nexe打包 #

nexe和pkg功能类似，支持自定义Node.js版本，打包后的文件体积相对可控。

• 操作步骤：
  • 全局安装nexe：npm install -g nexe
  • 直接打包入口文件：nexe index.js
  • 如需指定平台和Node版本：nexe index.js -t windows-x64-18.17.0
  • 生成的可执行文件直接复制到客户端运行即可。

3. 使用Electron打包（适用于带UI的桌面项目） #

如果你的Node.js项目包含可视化界面，Electron可以把项目打包成跨平台桌面应用，内置Chromium浏览器和Node.js运行时。

• 操作步骤：
  • 安装依赖：npm install electron electron-builder --save-dev
  • 在package.json中配置脚本和入口：

    {
      "main": "main.js",
      "scripts": {
        "dist": "electron-builder"
      }
    }
    

  • 执行npm run dist，打包完成后dist目录会生成对应平台的安装包或绿色版程序，客户端直接安装/运行即可。

额外提示 #

• 打包前务必在开发环境验证项目能正常运行，所有依赖都已安装并测试通过。
• 涉及文件读写的项目，要确保客户端服务器给可执行文件分配了对应的读写权限。
• 若项目需要环境变量配置，可以把配置文件和可执行文件一起复制，或在打包时将配置内置到代码中。

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