cocos2dx lua vscode调试

### 设置VSCode调试Cocos2d-x Lua项目

为了在Visual Studio Code (VSCode) 中设置Lua调试器用于Cocos2d-x游戏开发，需完成几个关键配置步骤。这些步骤确保能够顺利地创建、运行并调试基于Lua脚本的游戏。

#### 安装必要的扩展
首先，在VSCode内安装`Lua`插件以获得语法高亮和支持其他Lua特性。通过市场搜索“Lua”，选择合适的Lua扩展程序进行安装即可[^3]。

#### 配置环境变量
对于Cocos2d-x Lua项目的调试来说，正确配置环境非常重要。如果尚未全局安装Cocos命令行工具，则应在每次启动终端前手动指定路径至解压缩后的Cocos2d-x引擎内的`bin`文件夹位置[^4]。

#### 初始化新项目
利用Cocos提供的命令行工具可以快速建立一个新的Lua项目结构。例如：

cocos new MyGameProject -l lua -p com.example.mygameproject -d path/to/project/directory

此命令将在给定的目标目录下生成一个名为MyGameProject的新工程，并将其包名设为com.example.mygameproject[^2]。

#### 调试配置
要在VSCode中启用Lua代码的断点调试功能，需要编辑`.vscode/launch.json`文件加入如下所示的内容：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lua-local",
            "request": "attach",
            "name": "Attach to running game",
            "host": "localhost",
            "port": 8172,
            "stopOnEntry": false,
            "pathMappings": [
                {
                    "localRoot": "${workspaceFolder}",
                    "remoteRoot": "."
                }
            ]
        },
        {
            "type": "lua-local",
            "request": "launch",
            "name": "Launch Game with Debugger",
            "program": "./build/${os}/bin/cocos2dx.lua", // 根据操作系统调整路径
            "args": ["${workspaceFolder}"],
            "cwd": "${workspaceFolder}"
        }
    ]
}

上述JSON片段定义了两种不同的调试模式：“附加到正在运行的游戏”允许连接已启动的应用；而“带调试器启动游戏”则会在应用启动时自动加载调试器。