NW.js入门指南：从零开始构建桌面应用

2026-02-03 04:52:35作者：裘晴惠Vivianne

什么是NW.js？

NW.js（原名node-webkit）是一个基于Chromium和Node.js的开源框架，它允许开发者使用Web技术（HTML、CSS和JavaScript）来构建跨平台的桌面应用程序。NW.js的核心优势在于：

完整的浏览器环境：基于Chromium内核，支持所有现代Web API和最新的JavaScript特性
Node.js集成：可以直接在页面中调用Node.js模块和API
原生能力：提供丰富的原生API，如文件系统访问、原生菜单、系统托盘等
跨平台：支持Windows、macOS和Linux三大主流操作系统

环境准备与安装

获取NW.js

开发者可以直接从NW.js官方网站下载预编译的二进制文件。建议选择SDK版本进行开发，因为它包含了开发者工具（DevTools），便于调试应用。

NW.js提供两种构建版本：

普通版本：适合生产环境，体积较小
SDK版本：包含开发者工具，适合开发阶段使用

运行环境要求

操作系统：Windows 7+、macOS 10.10+或Linux
内存：建议至少2GB
磁盘空间：至少200MB可用空间

创建第一个NW.js应用

基础项目结构

一个最简单的NW.js应用只需要两个文件：

package.json - 应用清单文件
index.html - 应用主页面

1. 创建package.json

{
  "name": "my-first-nw-app",
  "main": "index.html",
  "version": "1.0.0",
  "description": "我的第一个NW.js应用"
}

关键字段说明：

name：应用唯一标识符（必须全小写，无空格）
main：指定应用启动时加载的入口文件
version：应用版本号
description：应用描述信息

2. 创建index.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>我的NW.js应用</title>
</head>
<body>
  <h1>欢迎使用NW.js</h1>
  <p>这是一个简单的桌面应用示例</p>
</body>
</html>

运行应用

在命令行中导航到项目目录，然后执行：

/path/to/nw .

Windows用户也可以直接将项目文件夹拖拽到nw.exe上运行。

进阶功能示例

使用NW.js原生API

NW.js提供了丰富的原生API，下面是一个创建右键菜单的示例：

<script>
// 创建菜单对象
const menu = new nw.Menu();

// 添加菜单项
menu.append(new nw.MenuItem({
  label: '复制',
  click: () => document.execCommand('copy')
}));

// 监听右键事件
document.addEventListener('contextmenu', (e) => {
  e.preventDefault();
  menu.popup(e.x, e.y);
});
</script>

集成Node.js功能

在NW.js中可以直接使用Node.js模块，例如文件系统操作：

<script>
const fs = require('fs');

// 读取当前目录下的文件列表
fs.readdir('.', (err, files) => {
  if (err) throw err;
  console.log('当前目录文件:', files);
});
</script>

使用npm模块

NW.js完全支持npm生态系统，安装和使用方式与Node.js项目相同：

npm install lodash

然后在代码中使用：

const _ = require('lodash');
console.log(_.chunk([1, 2, 3, 4], 2));  // 输出: [[1, 2], [3, 4]]

调试与开发技巧

开发者工具：在SDK版本中按F12或右键选择"检查"打开开发者工具
控制台日志：使用console.log()输出调试信息
热重载：修改代码后保存，按Ctrl+R刷新应用
远程调试：可以通过Chrome浏览器的远程调试功能连接NW.js应用

常见问题与解决方案

窗口白屏：检查package.json中的main字段路径是否正确
Node模块无法加载：确保原生模块使用nw-gyp重新编译
跨域请求问题：NW.js中默认没有同源策略限制
性能优化：对于计算密集型任务，考虑使用Web Worker

后续学习路径

掌握基础后，可以进一步学习：

应用打包与分发
使用NW.js原生UI组件
实现系统托盘功能
处理多窗口应用
应用自动更新机制

NW.js为Web开发者打开了通往桌面应用开发的大门，结合Web的灵活性和Node.js的强大能力，你可以构建出功能丰富、跨平台的桌面应用程序。

nw.js

Call all Node.js modules directly from DOM/WebWorker and enable a new way of writing applications with all Web technologies.

项目地址：https://gitcode.com/gh_mirrors/nw/nw.js

登录后查看全文