CI/CD流水线报错TS2339：$router不存在于CreateComponentPublicInstance类型

• 检查TypeScript配置中是否引入vue-router类型
  在tsconfig.json的compilerOptions.types数组里添加vue-router，确保配置如下：

  {
    "compilerOptions": {
      "types": ["vue-router"]
    }
  }
  

• 补充全局组件属性类型声明
  在项目src目录下创建或修改shims-vue.d.ts文件，添加$router的类型声明：

  import { Router } from 'vue-router'
  
  declare module '@vue/runtime-core' {
    interface ComponentCustomProperties {
      $router: Router
    }
  }
  

• 对齐本地与CI环境的TypeScript版本
  执行本地tsc -v查看版本，在package.json的devDependencies里锁定该版本，避免CI环境安装不同版本导致类型检查差异：

  "devDependencies": {
    "typescript": "^5.0.0" // 替换为你本地的实际版本号
  }
  

• 改用Composition API的useRouter钩子（推荐Vue 3项目）
  替换Options API中this.$router的用法，直接使用useRouter()获取路由实例，从根源避免类型问题：

  import { useRouter } from 'vue-router'
  
  export default {
    setup() {
      const router = useRouter()
      const doLogout = () => {
        // 你的logout业务逻辑
        router.push('/')
      }
      return { doLogout }
    }
  }
  

• 确保CI环境依赖安装严格一致
  在CI脚本中使用npm ci（而非npm install）或yarn install --frozen-lockfile，严格按照锁文件安装依赖，避免版本偏差。

内容的提问来源于stack exchange，提问作者King