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

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

Java

nop-entropy

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。