Android手机通过Termux安装Node.js运行JavaScript教程

在Android手机上运行JavaScript代码并不需要复杂的云服务器或专门的编程手机，借助开源的高级终端模拟器Termux，你可以直接在Android底层Linux环境中获得完整的Node.js运行时与npm包管理器。本文将详细讲解从获取正确的Termux版本、换源配置、安装Node.js，到实际编写并执行JavaScript脚本、启动本地HTTP服务的完整操作路径与常见问题解决办法。

一、准备工作：选择与获取正确的 Termux

在 Android 上搭建环境的第一步是获取正确的 Termux 安装包。这里有一个极其关键的注意事项：切勿从 Google Play 商店安装 Termux。

Google Play 上的 Termux 版本早在 2020 年因目标 API 级别限制已停止维护，更新源全部失效，无法直接安装任何软件包。目前官方活跃维护渠道为 F-Droid 或其官方 GitHub Releases 仓库。请确保手机系统为 Android 7.0 或更高版本。

二、核心安装步骤：从配置源到安装 Node.js

安装好 Termux 之后，推荐按照标准流程进行环境初始化、更新及安装。

步骤 1：更换为国内镜像源（推荐）

由于默认源在海外，直接下载可能速度较慢甚至中断。在终端输入以下命令：

termux-change-repo

界面会弹出图形化选项：第一页按回车选中默认的 Main Repository，第二页上下移动光标选择 Mirrors by BFSU（北京外国语大学）或 Tsinghua（清华大学），按回车确认即可自动修改源地址。

步骤 2：更新基础软件仓库

在安装具体软件之前，先刷新本地包列表并升级底层环境：

pkg update && pkg upgrade -y

如果在升级过程中出现关于配置文件覆盖的询问（例如 default [default=N] ?），直接按回车保持默认设置即可。

步骤 3：安装 Node.js

Termux 软件库中提供了两种 Node.js 版本：常规当前版本（nodejs）以及长期支持版（nodejs-lts）。两者二选一即可，日常练习与学习建议选择常规版，若项目强调兼容稳定性可选择 LTS 版。

# 安装常规当前版本（推荐）
pkg install nodejs -y

# 或者如果需要长期支持版本
# pkg install nodejs-lts -y

步骤 4：验证安装状态

安装完成后，检查 Node.js 以及随附安装的 npm 命令行工具：

node -v
npm -v

若屏幕打印出对应的版本号（例如 v20.x.x 和 10.x.x），则表明 Node.js 运行时已成功部署在手机环境中。

三、运行 JavaScript 的三种常用方式

Node.js 安装完成后，可以通过交互式解释器（REPL）、执行独立脚本文件，或者启动本地网络服务来运行 JavaScript。

1. REPL 交互式环境

直接输入 node 回车，即可进入交互式命令行。在光标后直接输入任何合法的 JavaScript 表达式即可执行：

$ node
Welcome to Node.js v20.x.x.
Type ".help" for more information.
> const greetings = "Hello from Android!";
undefined
> greetings.toUpperCase();
'HELLO FROM ANDROID!'
> 

要退出交互环境，连续按下快捷键 Ctrl + D，或者输入 .exit 并回车。

2. 编写并运行 .js 脚本文件

在手机上编写文件，可以先安装轻量级文本编辑器 nano：

pkg install nano -y

接着新建一个名为 main.js 的脚本文件：

nano main.js

在编辑器中输入以下简单的 JavaScript 代码：

const os = require('os');

console.log("=== 系统与运行环境信息 ===");
console.log(`平台架构: ${os.arch()}`);
console.log(`内存总量: ${(os.totalmem() / 1024 / 1024).toFixed(1)} MB`);
console.log(`Node版本: ${process.version}`);
console.log("JavaScript 在 Android Termux 环境中运行成功！");

保存退出方法：按手机屏幕下方的 Ctrl 辅助键，随后按键盘字母 O 回车保存，再按 Ctrl + X 退出。

运行该脚本文件：

node main.js

3. 启动一个简单的 Web 服务器并在手机浏览器中访问

Node.js 内置了强大的网络模块，可以在手机上直接搭建 HTTP 服务。创建 server.js：

const http = require('http');

const PORT = 3000;
const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  res.end('<h1>你好！这是运行在 Android 手机上的 Node.js 服务器</h1><p>当前时间: ' + new Date().toLocaleString() + '</p>');
});

server.listen(PORT, () => {
  console.log(`服务已启动，请打开浏览器访问: http://localhost:${PORT}`);
});

运行 node server.js 后，打开手机上的 Chrome 或任意浏览器，在地址栏输入 http://localhost:3000，即可看到手机自身提供的 Web 页面。

四、进阶配置与常见问题处理

1. 申请手机内部存储权限

默认情况下，Termux 运行在其私有沙盒目录中，手机自带的文件管理器或第三方代码编辑器（如 Acode）无法直接修改其内部文件。建议执行以下命令获取常规存储访问权限：

termux-setup-storage

手机系统会弹出权限授权弹窗，点击“允许”。执行后，用户家目录下会生成一个 storage 软链接目录，通过它你可以自由读写手机内部存储中的文件夹，方便使用图形化编辑器写代码，在 Termux 中执行。

2. 防止后台休眠被系统清理

Android 系统的电池优化策略容易在手机锁屏后强行冻结或杀死后台进程。如果需要运行持续的服务或进行耗时下载，请下拉通知栏，在 Termux 的常驻通知上点击 Acquire Wakelock；或者在终端中运行：

termux-wake-lock

3. 安装 npm C++ 原生扩展报错

部分 npm 第三方模块包含 C/C++ 原生编译代码（如 node-sass、sqlite3）。在 Termux 下直接安装这类包可能会因为缺少原生编译工具链报错。如遇此情况，可提前安装基础构建套件：

pkg install build-essential python -y

五、总结

通过 Termux 在 Android 手机上配置 Node.js，不仅轻便快捷，而且获得了几乎完整的 Linux CLI 生态支持。核心步骤可以归纳为三点：选择 F-Droid 渠道获取有效的 Termux、换源更新后使用 pkg install nodejs 安装运行时、使用 node 命令执行交互或独立脚本。熟练掌握这一环境后，你可以随时利用碎片时间进行 JavaScript 语法实验、小型服务端测试或脚本自动化任务。