答案：需在Node项目中显式配置AWS SDK的endpoint为http://localhost:4566，并在launch.json中设type为"node"、通过env注入AWS_ENDPOINT_URL等环境变量，同时用awslocal手动部署函数至LocalStack。
VSCode里Node项目怎么连LocalStack的Lambda？
直接连不上，是因为默认AWS SDK走的是真实AWS endpoint。必须显式覆盖endpoint和region，否则lambda.invoke()或s3.listBuckets()全发到云端去了——本地服务根本收不到请求。
Node.js项目中，初始化AWS.Lambda或AWS.S3实例时，得手动传参：
-
endpoint填http://localhost:4566（LocalStack默认端口） -
region可以任意设（如us-east-1），但必须有值，否则SDK报错 - 如果用
@aws-sdk/client-lambdav3，构造LambdaClient时传{ endpoint: "http://localhost:4566" } - 用
aws-sdkv2，构造new AWS.Lambda({ endpoint: "http://localhost:4566" })
漏掉endpoint是本地调试失败最常见原因，错误现象是超时或Connection refused，而不是“找不到服务”。
launch.json里type该选"node"还是"aws-sam"
选"node"——因为你在用LocalStack，不是SAM CLI。填"aws-sam"会导致VS Code去调sam local invoke，而LocalStack根本没这玩意儿，调试器直接连不上进程。
正确配置示例：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch LocalStack Lambda",
"program": "${workspaceFolder}/src/handler.js",
"env": {
"AWS_ENDPOINT_URL": "http://localhost:4566",
"AWS_REGION": "us-east-1",
"AWS_ACCESS_KEY_ID": "test",
"AWS_SECRET_ACCESS_KEY": "test"
}
}
]
}
注意：env里塞凭证不是为了认证（LocalStack默认跳过认证），而是防止SDK因缺环境变量报错；AWS_ENDPOINT_URL会被SDK自动读取，比代码里硬编码更干净。
LocalStack启动后，Node代码调Lambda总报NoSuchFunction
不是函数没注册，是LocalStack里根本没部署——它不像真实AWS那样自动加载你本地的handler.js。你得手动用awslocal（LocalStack自带CLI）把函数推上去。
- 先确保LocalStack已运行：
docker ps | grep localstack - 执行部署命令：
awslocal lambda create-function --function-name my-test --runtime nodejs18.x --role arn:aws:iam::000000000000:role/dummy --handler index.handler --zip-file fileb://./dist/index.zip -
zip-file必须是实际存在的ZIP包，不能是目录；用npm run build生成dist/再打包 - 如果用ESM，
--handler写成index.mjs::handler，不是index.mjs.handler
没执行create-function就直接调invoke，LocalStack返回的NoSuchFunction错误和AWS线上一模一样，容易误判为路径问题。
调试时断点不命中，但控制台有输出
说明代码确实跑了，但VS Code没挂上调试器——大概率是launch.json里program指向了错误入口文件，或者Node启动参数没对齐。
- 确认
program路径是相对${workspaceFolder}的，比如src/handler.js，别写成./src/handler.js（VS Code解析会出错） - 如果项目用TypeScript，
program必须指向编译后的.js文件，不是.ts源码 - 检查
node_modules/.bin/ts-node是否在PATH里，否则ts-node调试模式会静默失败 - 加一句
console.log('debugger port:', process.debugPort)，确认Node确实启用了调试端口
LocalStack本身不参与调试链路，它只响应HTTP请求；真正决定断点能否命中的，全是VS Code + Node.js这一侧的配置细节。
