调试Python时需在.vscode/launch.json中配置"args"字段，每个参数单独成字符串，F5启动才生效；“Debug Python File”按钮默认不读args，须设"purpose": ["debug-in-terminal"]并命名配置为Python: Current File (Integrated Terminal)。
调试 Python 时怎么传 args？
必须通过 launch.json 配置，点“Debug Python File”按钮或右键“Run Python File”都**不会读取 args 字段**。这是最常踩的坑。
实操步骤：
- 在项目根目录下确保有
.vscode/launch.json（没有就按Ctrl+Shift+P→ 输入Debug: Open launch.json创建） - 在对应配置里加
"args": ["--verbose", "--input", "data.txt"]—— 每个参数单独一个字符串，不要拼成"--verbose --input data.txt" - 用
F5或“Run and Debug”面板顶部下拉菜单选择该配置启动，参数才生效 - 如果想让“Debug Python File”按钮也带参，需在
launch.json中添加"purpose": ["debug-in-terminal"]，并确保配置名是Python: Current File (Integrated Terminal)
code 命令启动 VSCode 时路径为什么总打不开？
VSCode 不解析波浪线（~），也不自动切换工作目录。你敲 code ~/my-project，它真去字面路径找，而不是你家目录下。
正确做法：
- 先
cd到目标目录，再执行code .（最稳） - 用绝对路径：
code /home/user/my-project（Linux/macOS）或code C:\Users\user\my-project（Windows） - Windows PowerShell 中
code .\src可行，但 CMD 推荐用正斜杠：code ./src，避免反斜杠被转义 - 路径含空格或中文？必须加双引号：
code "./my project"
如何让 code 启动后阻塞终端？
--wait 只在首次启动 VSCode 实例时有效；如果后台已有进程，它会立刻返回，不等你编辑完。
要真正阻塞：
- 加
--new强制新开实例：code --new --wait README.md - 配合
--diff时--wait仍有效，适合写 Git hook：code --diff old.js new.js --wait - 脚本中别只依赖
--wait，先检查是否有运行中的 VSCode：pgrep -f "Code Helper" >/dev/null || code --new --wait file.txt
能不能用命令行指定 settings.json 文件？
不能。--settings 参数根本不存在，任何类似写法都会被静默忽略或导致启动失败。
替代方案只有两个真实有效的路径：
- 用
--user-data-dir切换完整用户环境：code --user-data-dir="/path/to/config-profile"，它会把settings.json、扩展、快捷键全隔离 - 用白名单参数临时覆盖个别行为，比如
--disable-extensions、--read-only、--goto "file.py:10:5" - 验证是否支持某个参数：运行
code --help | grep settings，结果为空就说明不支持
真正容易被忽略的是：VSCode 启动后，process.argv 才是唯一可信的参数来源。打开 DevTools（Help → Toggle Developer Tools），输 process.argv 就能看到它实际收到了什么——别猜，直接看。
