# lua

**Repository Path**: chenbool/lua

## Basic Information

- **Project Name**: lua
- **Description**: lua
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Windows 下 Lapis 安装与示例

> 本目录提供 Windows 环境下快速搭建 Lapis 的步骤、常见问题、以及示例运行说明。

## 目录

- [准备工作](#准备工作)
- [安装步骤](#安装步骤)
- [环境验证](#环境验证)
- [运行示例](#运行示例)
- [问题排查](#问题排查)

## 准备工作

| 项目 | 说明 | 推荐版本 |
| --- | --- | --- |
| LuaRocks 下载 | 前往官方 Release 页面下载 Windows 预编译包 | `luarocks-3.11.1-windows-x86_64.zip` |
| 安装目录 | 建议使用纯英文路径，避免中文和空格 | `D:\lua`, `C:\lua`, `F:\lua` |

### 可选自动脚本

如果希望自动下载并解压，可以使用 `setup-lapis-windows.ps1`：

```powershell
.\bootstrap-lapis-windows.ps1 -InstallDir D:\lua
```

脚本会自动下载 `luarocks-3.11.1-windows-x86_64.zip` 并解压至指定目录。

## 安装步骤

### 1. 配置系统环境变量

1. 右键 “此电脑” → 属性 → 高级系统设置 → 环境变量
2. 选择系统变量 `Path`
3. 新增安装目录，例如：`D:\lua`
4. 保存并关闭终端
5. 重新打开 CMD 窗口

### 2. 验证基础环境

打开 CMD 并执行：

```cmd
lua -v
luarocks --version
```

如果输出版本号，则表示基础环境已经就绪。

### 3. 安装 Lapis

```cmd
luarocks install lapis
```

等待安装完成。

### 4. 验证 Lapis

```cmd
lapis --version
```

正常输出版本号则说明安装成功。

## 运行示例

本目录包含示例文件 `app.lua`。在当前目录执行：

```cmd
lapis server
```

然后打开浏览器访问：

```text
http://127.0.0.1:8080
```

如果页面显示 `Hello Lapis! Windows 运行成功`，说明示例项目已经正常运行。

## 问题排查

| 问题 | 可能原因 | 解决办法 |
| --- | --- | --- |
| `lapis` 命令不存在 | 安装目录未加入 `Path`，或终端未重启 | 确认 `D:\lua` 已加入 `Path`，重新打开 CMD |
| 安装超时 | 网络不稳定或下载失败 | 切换网络环境，重试安装 |
| 端口 8080 占用 | 服务器已被其他程序占用 | 使用 `lapis server -p 8090` |
| 中文路径报错 | 路径包含中文或空格 | 将项目移动到纯英文路径 |

## 快速命令参考

```cmd
lua -v
luarocks --version
luarocks install lapis
lapis --version
lapis server
lapis server -p 8090
```