# nodeVersion

**Repository Path**: crazyants/node-version

## Basic Information

- **Project Name**: nodeVersion
- **Description**: 一个基于 Web 的 Node.js 版本管理工具，用于配合 nvm 方便地查看和切换 Node.js 版本。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![效果](https://s2.loli.net/2026/01/15/D8Z5vze6fNRnjrx.jpg)
# Node.js 版本管理器

一个基于 Web 的 Node.js 版本管理工具，用于配合 nvm 方便地查看和切换 Node.js 版本。

## 功能特性

- 实时显示当前使用的 Node 版本
- 列出所有已安装的 Node 版本
- 点击即可切换版本
- 深色主题界面，简洁美观
- 支持开机自启动（Windows 服务）

## 系统要求

- Windows 操作系统
- 已安装 [nvm-windows](https://github.com/coreybutler/nvm-windows)
- 已安装 Node.js（通过 nvm 安装的任意版本）

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 启动服务

```bash
npm start
```

### 3. 访问页面

打开浏览器访问：`http://localhost:3000`

## 设置开机自启动

### 安装为 Windows 服务

```bash
node install-service.js
```

安装完成后服务会自动启动，之后开机都会自动运行。

### 服务管理命令

```bash
# 启动服务
net start NodeVersionManager

# 停止服务
net stop NodeVersionManager

# 卸载服务
node uninstall-service.js
```

### 查看 Windows 服务

1. 按 `Win + R`，输入 `services.msc` 回车
2. 找到 `NodeVersionManager` 服务

## 项目结构

```
nodeVersion/
├── server.js              # Express 后端服务
├── install-service.js     # 服务安装脚本
├── uninstall-service.js   # 服务卸载脚本
├── package.json           # 项目配置
├── public/
│   ├── index.html         # 前端页面
│   ├── app.js            # 前端逻辑
│   └── style.css         # 样式文件
└── README.md             # 说明文档
```

## API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/current` | GET | 获取当前 Node 版本 |
| `/api/versions` | GET | 获取所有已安装版本 |
| `/api/use` | POST | 切换到指定版本 |

## 资源占用

- 内存：约 20-50MB
- CPU：空闲时接近 0
- 端口：3000

## 常见问题

**Q: 端口 3000 被占用怎么办？**

A: 修改 `server.js` 中的 `PORT` 变量为其他端口。

**Q: 切换版本后需要重启终端吗？**

A: 是的，切换版本后新开一个终端窗口才会生效。

**Q: 如何修改服务名称？**

A: 编辑 `install-service.js` 和 `uninstall-service.js` 中的 `name` 字段。

**Q: 开机后发现服务没有启动，在 Windows 服务中看到可执行文件路径指向不存在的 exe？**

A: 这通常发生在以下情况：
- 换电脑或重新克隆仓库后
- 杀毒软件误删了 exe 文件
- 手误删除了 daemon 目录

**解决方法：重新安装服务**

```bash
node install-service.js
```

说明：`daemon` 目录被 `.gitignore` 忽略，其中的 `nodeversionmanager.exe` 由 `node-windows` 自动生成，不会被 git 追踪。每次换环境或 exe 丢失时都需要重新运行安装脚本。

## License

MIT