“Name is already defined”是语言服务的保护机制，因新名在当前或导出作用域中已存在声明（如变量、函数、类型）而拒绝重命名；应先用Ctrl+Shift+O搜索确认冲突，改用更具体名称或手动删除冲突声明后再重命名。
重命名时提示“Name is already defined”怎么办
VSCode 的 rename symbol 操作（F2）在目标名称已被占用时会直接报错，不执行任何修改。这不是 bug，而是语言服务的保护机制——它检测到新名字在当前作用域或导出范围内已存在变量、函数、类型等声明，拒绝覆盖。
常见触发场景：
- 想把
getUser改成fetchUser，但项目里已有const fetchUser = ...或function fetchUser() - TypeScript 中重命名类型别名，而同名接口（
interface FetchUser）已存在 - 跨文件重命名后，另一个文件中同名但不同作用域的变量被语言服务误判为冲突（尤其在未配置
tsconfig.json时）
解决办法：
- 先用
Ctrl+Shift+O（Go to Symbol in Workspace）搜一下目标新名称，确认是否真有冲突；若只是局部变量，可忽略（语言服务有时过度敏感） - 改用更具体的名称，比如
fetchCurrentUser或apiFetchUser，避开全局命名空间 - 如果确定要覆盖（如清理旧代码），先手动删掉冲突声明，再执行重命名——不要跳过这步，否则语言服务可能静默失败
TypeScript 类型重命名为何总和 interface 冲突
TypeScript 中 type UserProps = {...} 和 interface UserProps 虽然语法不同，但在语言服务层面属于同一符号命名空间。重命名一个时，若另一个同名存在，rename symbol 就会卡住。
根本原因在于 TypeScript 编译器对“类型合并”的语义约束：即使二者不互相扩展，同名也会触发冲突检查。
实操建议：
- 重命名前运行
Ctrl+Shift+P → "TypeScript: Go to Type Definition"，看光标下符号实际解析到了哪个声明（type？interface？namespace？） - 统一类型定义风格：项目里只用
type或只用interface，避免混用；若必须共存，给 type 加后缀，如UserPropsType - 启用
"typescript.preferences.renameShorthandProperties": true（在设置中搜索），能缓解部分类型别名重命名受限问题
JavaScript 模块内重命名如何防止污染全局作用域
ES6 模块默认是严格作用域，但如果你在顶层用了 var、function 声明，或没加 "type": "module"，重命名可能意外影响其他模块——尤其当多个文件通过 IIFE 或 UMD 包裹时。
典型表现：重命名 utils.js 里的 formatDate，结果 main.js 里一个同名但完全无关的 function formatDate() 也被改了（说明语言服务没识别模块边界）。
关键控制点：
- 确保所有 JS 文件顶部有
"use strict";，且项目根目录存在jsconfig.json（哪怕空内容），否则 LSP 默认降级为全局分析模式 - 检查右下角语言模式是否为
javascript，不是javascriptreact或plaintext；React 文件里 JSX 属性名（如onSubmit）不会被重命名影响，但函数参数会 - 避免在模块顶层写
export default function foo() {}后又在同一文件写function foo() {}——这种重载式写法会让语言服务混淆作用域
重命名后发现 import 名没更新？检查导出方式
重命名导出的函数或类时，如果 import { xxx } 没跟着变，大概率不是重命名失败，而是导出方式不被语言服务追踪。
以下导出形式会被可靠识别：
-
export function apiCall() {}（具名导出） -
export default class ApiService {}（默认导出，但重命名后调用处需手动调整import ApiService from './x'）
这些则**不被支持**：
-
export default { apiCall }（对象字面量导出，LSP 无法建立符号绑定） -
module.exports = { apiCall }（CommonJS，仅限 Node.js 项目且需额外配置） -
const apiCall = () => {}; export { apiCall as default }（重命名apiCall不会更新as default别名）
安全做法：重命名前先按 Ctrl+Click 点击导入名，确认能跳转到真实定义；跳转失败，重命名必然漏改。
