在PyCharm中配置Windows系统下的Lua开发环境（附调试全流程）傻瓜式教学

前言

        对于需要同时进行Python和Lua开发的开发者而言，在PyCharm中直接运行调试Lua脚本可以显著提升开发效率。本文将详细介绍Windows系统下的完整配置流程，包含常见问题解决方案及优化建议。非必要步骤都已在标题后标识（如图），下滑至结语板块有简洁省流版。

话不多说，让我们开始今天的教学吧，实践时长约10min。

一、环境准备阶段

 1.1 安装Lua运行环境

推荐使用LuaForWindows集成包（当前最新版5.1）：
下载地址：

https://github.com/rjpcomputing/luaforwindows/releases

注意：安装路径建议保持默认`C:\Program Files (x86)\Lua\5.1`，避免后续路径配置问题。安装成功后的路径如图所示：

1.2 配置Lua包管理工具（LuaRocks）（PS：LuaRocks 作为 Lua 的包管理工具，极大地简化了依赖管理、版本控制等相关操作，并与其他工具和文档的集成。此步骤非必要，可略过）

1. 下载最新Windows版本：
访问以下地址：

https://github.com/luarocks/luarocks/wiki/Installation-instructions-for-Windows 

下载`luarocks-3.x.x-win32.zip`

2. 解压到Lua安装目录：
示例路径：C:\Program Files (x86)\Lua\luarocks-3.3.0-win32

3. 执行安装命令（管理员权限运行CMD）：

cd "C:\Program Files (x86)\Lua\luarocks-3.3.0-win32"

install.bat /F /LUA "C:\Program Files (x86)\Lua\5.1" /P "C:\Program Files (x86)\Lua\5.1\luarocks" /SELFCONTAINED /Q

4. 验证安装：cmd输入以下代码

where luarocks

正确应返回：`C:\Program Files (x86)\Lua\5.1\luarocks\luarocks.bat`

二、PyCharm插件配置

2.1 安装EmmyLua插件

1. 打开pycharm软件，找到以下路径File > Settings > Plugins（下图右上角位置也可）

2. Marketplace搜索"EmmyLua"

3. 安装后重启IDE

功能亮点：
- 智能代码补全
- 语法错误检查
- 调试器集成
- 文档即时提示

三、依赖包安装（此步骤非必要，可略过）

3.1 安装LuaSocket库

cmd输入已下代码

luarocks install luasocket

典型应用场景：
- 网络通信开发
- HTTP请求处理
- TCP/UDP协议开发

四、项目配置指南

4.1 创建Lua运行配置

1. pycharm界面点击`Run > Edit Configurations`

2. 点击`+`选择Lua application

3. 关键参数设置：见下图白框配置

program:C:\Program Files (x86)\Lua\5.1\lua.exe

working directory:C:\Program Files (x86)\Lua\5.1


 

 4.2 目录标记规范（此步骤非必要，可略过）

1. 项目根目录右键 -> `Mark Directory as -> Sources Root`
2. 建议项目存放路径：

C:\Program Files (x86)\Lua\MyProject

注意：这是LuaForWindows的默认模块搜索路径要求

五、新建lua文件

1.操作如图所示：

现在让我们看看成功没有，写一个简单的lua代码，点击运行后查看输出结果

六、常见问题排查

6.1 模块加载失败
- 症状：`module 'xxx' not found`
- 解决方案：
  1. 确认`package.path`包含项目路径
  2. 检查LUA_PATH环境变量
  3. 使用绝对路径引入

6.2 权限问题
- 症状：安装时报错/文件无法写入
- 解决方案：
  1. 以管理员身份运行CMD/PyCharm
  2. 关闭杀毒软件实时防护

6.3 路径包含空格
- 所有涉及Program Files的路径建议用双引号包裹
- 示例：cmd输入下面代码

cd "C:\Program Files (x86)\Lua\5.1"

结语

1)在pycharm点击file > Settings，选择左侧的 Plugins，然后在右侧的搜索栏输入 "EmmyLua" 搜索安装即可。

2)安装lua:  https://github.com/rjpcomputing/luaforwindows/releases

3)安装lua的包管理工具luarocks：https://github.com/luarocks/luarocks/wiki/Installation-instructions-for-Windows#The_default_settings，点击latest windows-32.zip file here，选一个包下载。

　　解压后放到lua的安装目录下,我的是C:\Program Files (x86)\Lua\luarocks-3.3.0-win32

　　然后命令行切换到C:\Program Files (x86)\Lua\luarocks-3.3.0-win32，执行：

　　install.bat /F /LUA C:\Program Files (x86)\Lua\5.1 /P C:\Program Files (x86)\Lua\5.1\luarocks-3.3.0 /SELFCONTAINED /Q

　　重开一个命令行，输入where luarocks，不报错则说明安装成功。

4)安装luasockets:

　　命令行下输入luarocks install luasocket

5）创建lua文件，运行前配置，

　　program:C:\Program Files (x86)\Lua\5.1\lua.exe

　　working directory:C:\Program Files (x86)\Lua\5.1

6）需要把右键 mark director as Sources Root

　并把整个项目放到C:\Program Files (x86)\Lua目录下，才可以调试。