args字段仅在F5调试时生效，右键“Run Python File”、Code Runner及默认“Debug Python File”按钮均不读取；必须配置为字符串数组且参数解析逻辑置于if name == "__main__":块内。
launch.json里args字段只对F5调试生效
右键“Run Python File”、Code Runner插件、甚至“Debug Python File”按钮默认都不读args——这是最常配错的地方。参数只在F5启动调试会话时由VSCode调试器注入sys.argv，其他运行方式完全无视它。
实操要点：
-
args必须是字符串数组，不能拼成单个字符串：["--port", "8080", "--debug"]✅，["--port 8080"]❌ - 含空格的值直接用双引号包裹：
["--name", "Alice Smith"]→sys.argv[2]就是Alice Smith - 参数解析逻辑（如
argparse.ArgumentParser()）必须放在if __name__ == "__main__":块内，否则模块导入阶段就报错 - 每次F5前务必确认左下角调试配置名称已选中你刚改过的那一项，VSCode不会自动记住上次选择
Java项目需显式指定mainClass和projectName
Spring Boot或多模块Maven项目中，VSCode无法自动识别哪个类是真正的启动入口。不写mainClass，调试器可能加载错模块的类；不填projectName，classpath容易漏掉依赖模块的target/classes，导致ClassNotFoundException。
关键配置项：
-
mainClass必须写全限定名，例如"com.example.bootstrap.BootstrapApplication"，不能只写类名 -
projectName要与pom.xml中 - 多模块项目建议在
launch.json中加"env": {"MAVEN_OPTS": "-Dmaven.repo.local=/path/to/local/repo"}，避免因本地仓库路径不一致导致依赖解析失败
命令行启动参数和GUI设置不是一回事
VSCode的code命令行参数（如--reuse-window、--folder-uri）控制的是编辑器实例的生命周期和工作区加载行为，和launch.json里的args完全无关。混淆这两者会导致“明明写了参数却没生效”的困惑。
常见误用场景：
- 以为
code --args="--port=8080"能传给Java程序——实际无效，--args不是VSCode支持的flag - 在GUI里改了
settings.json想影响调试参数——不行，args只来自launch.json或调试面板输入框 - 用
code -r ./my-project启动后仍打不开项目：路径不能带~，code -r ~/project会失败，必须用绝对路径或先cd再code -r .
多模块Maven项目最容易漏掉classpath配置
VSCode Java调试器不会自动把所有子模块的target/classes加进classpath。如果只配置了mainClass但没确保语言服务器已完成多模块索引，调试时就会找不到自己写的Service类或DTO类。
验证和修复步骤：
- 打开命令面板（
Ctrl+Shift+P），运行Java: Reload Project，强制刷新依赖树 - 检查状态栏右下角是否显示
Java Language Server: Ready，未就绪时调试必然失败 - 在
launch.json中显式添加"classPaths": ["./module-a/target/classes", "./module-b/target/classes"]（不推荐长期用，仅临时验证） - 终极方案：确保根
pom.xml中pom.xml的
复杂点在于：launch.json的args、命令行的code参数、Java项目的Maven构建状态，三者各自独立又相互耦合。任何一个环节没对齐，参数就卡在半路——不是没传，而是根本没走到能接收它的地方。
