TypeScript接口能推导出完整参数类型，而JS对象字面量不行，因为TS接口是编译前被AST解析器识别的明确结构契约，而JS对象缺乏类型注解，LSP只能做浅层运行时推测，无法保证字段必填、可选或嵌套深度。
为什么 TypeScript 接口能推导出完整参数类型，而 JS 对象字面量不行
VSCode 插件（如 Pylance、TypeScript 语言服务器）对参数类型的推导能力，本质依赖静态类型信息是否可达。TypeScript 接口声明 interface User { id: number; name: string } 在编译前就被 AST 解析器识别为明确的结构契约；而 JavaScript 中 const user = { id: 1, name: "Alice" } 缺乏类型注解，LSP 只能做浅层运行时推测，无法保证字段必填、可选或嵌套深度。
- TS 接口 + JSDoc @param 注释 → 可推导出参数名、类型、是否可选、默认值
- JS 对象字面量 → 仅能识别基础字段名和字面量类型（如
"string"、42），不识别undefined或null意图 - 无类型注解的函数（如
function foo(x) { ... }）→ 参数提示框显示为空或any
如何让自定义函数在 VSCode 中显示准确的参数提示
关键不是“插件做了什么”，而是“你提供了什么”。VSCode 不会猜类型，它只消费你写的类型定义。
- TS 项目：给函数加完整签名，例如
function createUser(name: string, age?: number): User - JS 项目：用 JSDoc 显式标注，必须紧贴函数上方，且格式严格：
/**\n * 创建用户\n * @param {string} name 用户姓名\n * @param {number} [age] 年龄（可选）\n * @returns {User}\n */\nfunction createUser(name, age) { ... } - 确保文件有正确语言模式：右下角显示
TypeScript或JavaScript React，不是Plain Text - 若引用第三方库函数没提示，检查
node_modules/@types/xxx是否存在，或手动安装类型包（如npm install --save-dev @types/lodash）
Ctrl+Shift+Space 没反应？先查这三件事
快捷键失效几乎从不因为快捷键本身坏了，而是底层 LSP 没就绪或配置被覆盖。
- 状态栏右下角语言标识是否为
TypeScript/Python？不是就按Ctrl+K Ctrl+M手动设 -
editor.parameterHints.enabled是否为true？在设置里搜这个配置项确认 - 光标是否紧贴左括号右侧？例如写
fetch(|)是对的，fetch( |)或换行后敲快捷键都无效 - Mac 用户注意：
Cmd+Shift+Space默认被 Spotlight 占用，需在系统设置里关掉，或改 VSCode 快捷键绑定
Pylance 和 TypeScript 语言服务器对参数提示的影响差异
Python 和 TS 的提示来源机制不同，不能套用同一套调试逻辑。
- Python 依赖 Pylance：必须启用
"python.languageServer": "Pylance"，基础 Python 扩展不提供参数提示 - TypeScript 依赖内置 TS Server：需确保项目有
tsconfig.json，否则即使装了 TS 扩展，LSP 也可能降级为简单语法分析 - 两者都要求类型定义可达：Pylance 需要
.pyi文件或带类型注解的源码；TS Server 需要.d.ts或内联接口 - 动态生成函数（如装饰器工厂、
eval构建）基本无法提示——这不是插件缺陷，是静态分析的天然边界
实际项目里最常被忽略的，是语言模式和类型定义路径之间的断连。比如一个 .js 文件里写了 JSDoc，但 VSCode 当前把它当成了 JSON 模式，那所有注释都会被无视。这种问题不会报错，只会静默失效。
