launch.josn
时间: 2025-07-09 10:12:22 浏览: 10
### 配置指南
在 VS Code 中,`launch.json` 是用于配置调试器的核心文件。该文件通常位于 `.vscode` 文件夹下,并且可以定义多个调试配置,以支持不同的调试场景和语言环境。
#### 基本结构
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 当前文件",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"justMyCode": true,
"env": {
"PYTHONPATH": "${workspaceFolder}"
}
}
]
}
```
#### 参数说明(以 LuaPanda 调试器为例)
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `isNeedB64EncodeStr` | boolean | `true` | 是否对传输字符串进行 Base64 编码 |
| `pathCaseSensitivity` | boolean | `false` | 路径是否区分大小写 |
| `distinguishSameNameFile` | boolean | `false` | 是否区分同名文件 |
| `VSCodeAsClient` | boolean | `false` | 是否反转 VSCode 和 Lua 进程的客户端/服务端关系 |
#### 最佳实践建议
- **路径配置**:尽量使用相对路径,如 `"${workspaceFolder}/path"` 形式。
- **端口冲突**:如遇到连接问题,可尝试修改 `connectionPort`。
- **性能优化**:稳定后可关闭 `stopOnEntry` 提升调试效率。
- **版本升级**:升级后如遇问题,可删除 `launch.json` 重新生成。
- **同名文件**:避免在项目中存在同名 Lua 文件,或在必要时开启 `distinguishSameNameFile` [^2]。
---
### 常见问题解答
#### 1. 如何创建一个基本的 `launch.json` 文件?
可以通过 VS Code 的调试功能自动创建一个模板文件。打开调试面板 (`Ctrl + Shift + D`),点击“创建 launch.json 文件”,选择合适的调试器类型即可生成基础配置 [^3]。
#### 2. 如何配置 Python 环境的调试器?
以下是一个典型的 Python 调试配置:
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 当前文件",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"justMyCode": true,
"env": {
"PYTHONPATH": "${workspaceFolder}"
}
}
]
}
```
此配置将启用集成终端运行当前文件,并设置 `PYTHONPATH` 为工作区根目录 [^3]。
#### 3. 如何解决调试时的端口冲突问题?
如果遇到端口冲突问题,可以手动修改 `launch.json` 中的 `connectionPort` 参数,选择一个未被占用的端口号。例如:
```json
"connectionPort": 8899
```
确保所选端口未被其他服务占用,以避免连接失败 [^2]。
#### 4. 如何调试嵌入在宿主程序中的 Lua 脚本?
对于嵌入在 C++/C# 或游戏引擎(如 Unity、Unreal)中的 Lua 脚本,推荐使用自适应模式。这种模式适合调试整个项目而非单个文件的情况 。
#### 5. 如何调试独立的 Lua 脚本文件?
如果只是调试独立的 Lua 脚本文件,可以选择单文件模式。这种方式适用于快速测试某个 Lua 函数的功能,不需要启动宿主程序的简单调试场景 [^2]。
---
###
阅读全文
相关推荐

















