VSCode的launch.json支持自定义变量提升调试灵活性，可通过env定义环境变量、variables声明全局变量，并结合内置变量如${workspaceFolder}和${file}实现路径动态配置，还可通过.env文件或扩展管理敏感信息，避免硬编码。
VSCode 的调试配置允许你使用自定义变量，以便在调试过程中动态地调整参数、路径或其他配置信息。这极大地提高了调试的灵活性，尤其是在处理复杂的项目结构或需要根据环境变化进行调试时。
解决方案：
VSCode 的 launch.json 文件是调试配置的核心。你可以在这个文件中定义自定义变量，并在其他配置项中使用它们。
-
定义变量： 在
launch.json文件的configurations数组中，你可以找到一个名为env的对象。如果不存在，你可以手动添加它。在这个对象中，你可以定义你的自定义变量，例如：{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "env": { "MY_CUSTOM_VARIABLE": "my_value", "PROJECT_ROOT": "${workspaceFolder}" } } ] }在这个例子中，我们定义了两个变量：
MY_CUSTOM_VARIABLE和PROJECT_ROOT。PROJECT_ROOT使用了 VSCode 内置的变量${workspaceFolder}，它代表当前工作区的根目录。 -
使用变量： 定义了变量之后，你可以在
launch.json文件的其他配置项中使用它们。例如，你可以将自定义变量用于指定程序的启动参数：{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "args": [ "--custom-arg", "${env:MY_CUSTOM_VARIABLE}" ], "env": { "MY_CUSTOM_VARIABLE": "my_value", "PROJECT_ROOT": "${workspaceFolder}" } } ] }这里，我们使用了
${env:MY_CUSTOM_VARIABLE}来引用我们定义的变量。在调试时，VSCode 会将这个变量替换为它的实际值 "my_value"。注意，使用env:前缀来访问环境变量。 -
环境变量覆盖： 如果你希望在调试时覆盖系统环境变量，你也可以在
env对象中进行设置。例如，如果你想临时修改PATH环境变量，你可以这样做：{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "env": { "PATH": "${env:PATH}:/path/to/my/tools" } } ] }这将把
/path/to/my/tools添加到现有的PATH环境变量中。
如何在不同的调试配置中复用自定义变量？
你可以使用 VSCode 的 "variables" 部分来定义全局变量，然后在不同的调试配置中引用它们。例如：
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Config 1",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"env": {
"API_URL": "${variables:apiUrl}"
}
},
{
"name": "Debug Config 2",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/test.js",
"env": {
"API_URL": "${variables:apiUrl}"
}
}
],
"variables": {
"apiUrl": "http://localhost:3000"
}
}在这个例子中，apiUrl 变量在 "variables" 部分定义，然后在两个不同的调试配置中使用。
如何根据不同的环境设置不同的变量值？
一种方法是使用不同的 launch.json 文件，例如 launch.dev.json 和 launch.prod.json，分别对应开发环境和生产环境。另一种方法是使用 VSCode 的扩展，例如 "env-cmd"，它允许你根据不同的 .env 文件设置不同的环境变量。
例如，安装 "env-cmd" 扩展后，你可以这样配置 launch.json：
Sylius开源电子商务平台是一个开源的 PHP 电子商务网站框架，基于 Symfony 和 Doctrine 构建，为用户量身定制解决方案。可管理任意复杂的产品和分类，每个产品可以设置不同的税率，支持多种配送方法，集成 Omnipay 在线支付。功能特点：前后端分离Sylius 带有一个强大的 REST API，可以自定义并与您选择的前端或您的微服务架构很好地配合使用。如果您是 Symfony
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug with .env",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"runtimeExecutable": "env-cmd",
"runtimeArgs": [
"-f",
"${workspaceFolder}/.env",
"node"
]
}
]
}然后，你可以创建 .env 文件，例如 .env.dev 和 .env.prod，分别包含开发环境和生产环境的变量。调试时，"env-cmd" 会自动加载相应的 .env 文件。
如何处理包含特殊字符的变量值？
如果变量值包含特殊字符，例如空格或引号，你需要对它们进行转义。在 launch.json 文件中，你可以使用双引号将变量值括起来，并使用反斜杠来转义特殊字符。例如：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"env": {
"MY_CUSTOM_VARIABLE": "\"value with spaces and \\\"quotes\\\"\""
}
}
]
}在这个例子中，我们使用双引号将变量值括起来，并使用反斜杠来转义引号。这样，变量值就可以正确地传递给程序。
自定义变量在调试复杂的构建流程中能起到什么作用？
在复杂的构建流程中，自定义变量可以用来配置构建脚本的路径、输出目录、编译器选项等。例如，假设你的项目使用 CMake 进行构建，你可以使用自定义变量来指定 CMake 的构建类型：
{
"version": "0.2.0",
"configurations": [
{
"name": "CMake Debug",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/build/${env:BUILD_TYPE}/my_program",
"cwd": "${workspaceFolder}",
"env": {
"BUILD_TYPE": "Debug"
},
"preLaunchTask": "cmake build"
},
{
"name": "CMake Release",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/build/${env:BUILD_TYPE}/my_program",
"cwd": "${workspaceFolder}",
"env": {
"BUILD_TYPE": "Release"
},
"preLaunchTask": "cmake build"
}
]
}在这个例子中，我们定义了一个 BUILD_TYPE 变量，用于指定 CMake 的构建类型。我们创建了两个调试配置，分别对应 Debug 和 Release 构建类型。在 preLaunchTask 中，我们执行 CMake 构建任务，该任务会根据 BUILD_TYPE 变量的值来构建相应的版本。
如何安全地处理敏感信息，例如 API 密钥或密码？
绝对不要将敏感信息直接存储在 launch.json 文件中，因为这个文件通常会提交到代码仓库。更好的方法是使用环境变量，并将敏感信息存储在系统环境变量中，或者使用 VSCode 的扩展，例如 "dotenv" 或 "vscode-secrets"，它们允许你安全地存储和管理敏感信息。
例如，使用 "dotenv" 扩展，你可以创建一个 .env 文件，并在其中存储敏感信息：
API_KEY=your_api_key DATABASE_PASSWORD=your_database_password
然后，在 launch.json 文件中，你可以使用 ${env:API_KEY} 和 ${env:DATABASE_PASSWORD} 来引用这些变量。
VSCode 内置变量有哪些常用的？
VSCode 提供了许多内置变量，可以在 launch.json 文件中使用。一些常用的内置变量包括：
-
${workspaceFolder}：当前工作区的根目录。 -
${workspaceFolderBasename}：当前工作区的根目录的名称。 -
${file}：当前打开的文件的完整路径。 -
${fileBasename}：当前打开的文件的名称，包括扩展名。 -
${fileBasenameNoExtension}：当前打开的文件的名称，不包括扩展名。 -
${fileDirname}：当前打开的文件的目录。 -
${cwd}：当前工作目录。 -
${env:Name}：访问环境变量Name。 -
${config:Name}：访问 VS Code 配置设置Name。
这些内置变量可以让你更灵活地配置调试环境，例如，你可以使用 ${file} 来指定要调试的文件，使用 ${workspaceFolder} 来指定工作目录。
