怎么在安卓手机上安装Node.js环境并运行JavaScript脚本

在移动办公、临时排查脚本或学习编程的场景下，直接在安卓手机上运行 JavaScript 脚本能够提供极大的便利。在安卓设备上搭建 Node.js 环境，最成熟且无需 Root 权限的标准方式是利用终端模拟器 Termux。通过 Termux 在安卓系统的 Linux 内核上构建的用户空间环境，可以像在常规 Linux 服务器中一样使用官方维护的包管理器安装 Node.js、执行 npm 包管理，并完整运行本地脚本或轻量服务。

一、前期准备与安装源的选择

在安卓设备上运行 Linux 环境，选择可靠的安装源至关重要。目前主流方案为 Termux，但获取途径直接决定了后续环境的稳定性。

• 不要使用 Google Play 版本：Google Play 应用商店上的 Termux 客户端早在 2020 年因目标 SDK 版本合规限制停止了后续更新，其内置的软件源均已失效，执行安装命令时会出现严重的依赖与网络报错。
• 推荐来源：请通过开源应用分发平台 F-Droid 或访问 Termux 的 GitHub Releases 页面下载最新的 APK 安装包（推荐下载适配当前设备的 termux-app_v..._arm64-v8a.apk）。
• 系统要求：建议设备运行 Android 7.0 及以上版本，并预留至少 500MB 的可用存储空间。

二、初始化 Termux 基础环境

首次安装并打开 Termux 时，应用会自动解压核心基础工具集。在开始安装具体运行库前，需要首先更新当前的软件包管理器：

pkg update && pkg upgrade -y

如果在更新期间弹出询问是否替换配置文件（例如 default [N]），直接按下回车键选择默认选项即可。这一步确保了本地软件索引与官方源保持最新，防止后续安装过程中找不到特定的依赖库。

三、安装 Node.js 与验证版本

Termux 软件仓库中提供了两个版本的 Node.js：nodejs（跟随最新的 Current 分支）以及 nodejs-lts（长期支持版本）。对于常规脚本开发与生产工具运行，推荐优先选择 LTS 版本，其生态兼容性更好。

1. 执行安装命令

pkg install nodejs-lts -y

安装完成后，系统会自动完成 Node.js 核心二进制文件以及自带的 npm（Node Package Manager）工具配置。

2. 验证安装结果

分别执行版本查询命令，若能正常打印出版本号，则表示运行环境已就绪：

node -v
npm -v

示例输出：

$ node -v
v20.12.2
$ npm -v
10.5.0

四、编写并运行第一个 JavaScript 脚本

环境安装完成后，可以通过终端编辑器或直接使用重定向符号快速生成一个简单的脚本并执行。

1. 创建脚本文件

Termux 内置了 nano 简易文本编辑器，也可以通过 cat 命令快速生成：

cat << 'EOF' > app.js
// 示例脚本：输出系统信息与基础计算
const os = require('os');

console.log('=== JavaScript 运行在安卓设备 ===');
console.log('系统架构:', os.arch());
console.log('系统平台:', os.platform());
console.log('当前时间:', new Date().toLocaleString());

// 模拟简易计算
const sum = [10, 20, 30, 40].reduce((acc, curr) => acc + curr, 0);
console.log('数组求和结果:', sum);
EOF

2. 执行脚本

在当前目录下直接调用 node 命令执行该文件：

node app.js

执行后终端即时输出以下内容，表明 JavaScript 代码已经在手机本地成功执行：

$ node app.js
=== JavaScript 运行在安卓设备 ===
系统架构: arm64
系统平台: android
当前时间: 2026/10/26 00:38:00
数组求和结果: 100

五、进阶应用：使用 npm 管理依赖并搭建 HTTP 服务

在安卓环境下，Node.js 并不局限于运行单文件脚本，它同样支持完整的包管理与网络服务搭建。

1. 初始化项目与安装依赖

创建一个专门的项目目录并安装常用的第三方工具包（例如日期处理库 dayjs）：

mkdir my-project && cd my-project
npm init -y
npm install dayjs

2. 创建并启动本地 HTTP 服务器

在 my-project 目录下创建 server.js：

cat << 'EOF' > server.js
const http = require('http');
const dayjs = require('dayjs');

const port = 3000;
const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
  res.end(`您好！这是运行在安卓手机上的 Node.js 服务。\n当前系统时间: ${dayjs().format('YYYY-MM-DD HH:mm:ss')}\n`);
});

server.listen(port, () => {
  console.log(`HTTP 服务已启动: http://localhost:${port}`);
});
EOF

启动该服务：

node server.js

保持 Termux 在后台运行，打开手机自带的任意浏览器（如 Chrome、Edge 或自带浏览器），在地址栏访问 http://localhost:3000，即可看到手机自身通过 Node.js 返回的响应内容。

六、关键概念辨析与避坑指南

在安卓设备上配置 Node.js 时，新手往往容易被一些流传的说法误导，以下针对常见问题进行分析：

1. 为什么“手机运行 Node 必须 Root”是不准确的？

该说法的合理性在于早年部分教程通过安装原生 Linux 发行版（如通过 Linux Deploy 部署 chroot 容器）并映射到系统底层目录，这确实需要 Root 权限。但现代的 Termux 采用了完全隔离的单一应用沙盒技术，所有二进制文件均直接编译并链接至 /data/data/com.termux/files/usr 路径下。只要 Node.js 监听的是 1024 以上的非特权端口（如 3000、8080），就完全符合 Android 原生权限模型，不需要任何越权操作。

2. 如何访问手机内部存储（相册/下载文件）？

默认情况下，Termux 运行在其独立的私有存储中。如果编写的 JS 脚本需要读取手机“下载”目录或相册文件，只需在终端中执行：

termux-setup-storage

在弹出的系统权限对话框中点击“允许”。之后即可在 ~/storage/shared/ 目录下直接访问手机主存储空间。

3. 防止后台脚本被系统清理

安卓系统的功耗管理机制经常会在锁屏后杀死后台运行的进程。为了保证长时间运行的爬虫脚本或 Node.js 服务不被意外终止：

• 在手机“设置 - 应用管理 - Termux”中，将“电池优化”设置为无限制或“不优化”。
• 下拉安卓系统通知栏，在 Termux 的常驻通知上点击 Acquire Wakelock（获取唤醒锁），以保证息屏状态下 CPU 持续运行。

七、常见故障排查

现象 / 报错	主要原因	针对性解决办法
Unable to locate package nodejs	软件源索引过期或使用了已失效的 Play Store 旧源	运行 pkg update；若仍失败，使用 termux-change-repo 切换可用镜像
安装依赖时 gyp ERR! build error	npm 包包含 C/C++ 原生模块，缺少编译链	执行 pkg install python make clang 安装编译基础工具后再尝试
EACCES: permission denied	脚本试图写入外部共享目录但未授权	运行 termux-setup-storage 授予存储读取权限
EADDRINUSE: address already in use	设定的网络监听端口已被前一个未完全退出的进程占用	使用 pkill -f node 停止残留的 Node 进程，或在代码中更换端口号

八、总结

在安卓手机上安装 Node.js 并运行 JavaScript 脚本，关键在于选择正确的工具链与安装源。通过 F-Droid 或 GitHub 获取最新版 Termux，利用 pkg install nodejs-lts 即可免 Root 快速搭建一个具备完整特性的开发与运行环境。配合系统存储权限的挂载与后台保活配置，安卓设备完全能够胜任日常脚本测试、定时爬虫任务以及轻量级 Web 服务的平稳运行。