vscode调试nestjs失败主因是上下文未正确加载：需确保根目录有含"include": ["src/*/.ts"]、"moduleresolution": "node"的tsconfig.json，重启ts服务器，并打开项目根目录而非子文件夹。
VSCode 调试 NestJS 失败，90% 不是代码问题，而是自动补全和跳转功能根本没加载对的上下文——jsconfig.json 或 tsconfig.json 缺失、@types 未安装、别名路径没对齐，都会导致 import 补全失效、Ctrl+Click 跳不到控制器、provide 参数提示为空。
为什么 import UserController 时没有自动补全？
不是 VSCode 坏了，是它压根没识别出你的模块结构。NestJS 项目默认用 TypeScript，但 VSCode 的语言服务需要明确的配置才能解析 src/**/* 下的类、装饰器和 provider 关系。
- 确保项目根目录有
tsconfig.json，且包含"include": ["src/**/*.ts"]（不能只写["src/**/*"]） -
"compilerOptions"中必须有"moduleResolution": "node"和"esModuleInterop": true，否则import { Controller } from '@nestjs/common'会被当作外部模块忽略 - 如果用了路径别名（如
@/common），tsconfig.json的"baseUrl"必须设为"."，"paths"要严格匹配nest build实际输出路径（比如"@/*": ["src/*"]） - 改完配置后，按
Ctrl+Shift+P→ 输入Restart TS server，不重启服务，补全不会更新
Ctrl+Click 跳不到 @Module() 里的 providers？
跳转失效，通常是因为 VSCode 没把 providers: [UsersService] 这种数组字面量当成类型引用处理——它只认显式 import 过的符号。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 所有被
@Module()引用的 service/controller 必须在当前文件顶部import，哪怕你只是想让它出现在跳转列表里 - 检查
UsersService是否导出了export class UsersService（不是export default class），NestJS 的 DI 容器和 TS 语言服务都依赖具名导出 - 如果 service 在
libs/子包里，确认该子包已通过npm link或yarn workspace正确链接，并且其package.json包含"types": "dist/index.d.ts" - 禁用插件
Auto Import或ES7 React Extensions，它们会劫持Ctrl+Click行为，导致跳转到错误位置
controller 方法参数没有自动提示（如 @Body() dto: CreateUserDto）？
这和 NestJS 装饰器本身无关，而是 TypeScript 类型推导链断了：从 @Body() 到 CreateUserDto 构造函数，再到其属性定义，每一步都需要可追溯的类型声明。
-
CreateUserDto必须是export class，且每个字段要有明确类型（name: string，不能只写name） - 确保
class-transformer和class-validator已安装，它们的@Type()、@IsString()等装饰器会增强 TS 语言服务对 DTO 结构的理解 - 如果 DTO 文件在
src/common/dto/，而 controller 在src/users/，tsconfig.json的"include"必须覆盖两者，例如["src/**/*.ts"] - 避免在 DTO 中使用
any或unknown作为字段类型，它们会让整个类的类型信息坍缩，补全直接消失
npm run start:debug 启动后断点灰了，但 Ctrl+Click 还能跳转？
说明语言服务（补全/跳转）和调试器（断点/变量监视）走的是两套独立系统。跳转正常只代表 TS 配置 OK；断点灰掉，100% 是 launch.json 或构建流程没对上 sourceMap。
- 删掉所有
request: "launch"的配置，改用request: "attach"，端口必须和nest start --debug 9229一致 -
outFiles必须写成["${workspaceFolder}/dist/**/*.js"]，漏掉**就找不到dist/users/users.controller.js - 运行
npm run start:debug后，立刻检查终端第一行是否输出Debugger listening on ws://127.0.0.1:9229/；没有就说明--inspect根本没生效 - 不要在
tsconfig.json里加"incremental": true，增量编译容易残留旧的.js.map，手动删掉dist/再nest build最可靠
最常被忽略的一点：VSCode 必须打开的是整个 NestJS 项目根目录，而不是某个子文件夹（比如只打开 src/）。否则 .vscode/ 配置不加载，tsconfig.json 被忽略，所有补全和跳转都会降级为纯文本匹配。
