1. 为什么“Git Worktree Claude Code”正在成为 Android 开发者的隐性生产力分水岭最近三个月我在三个不同客户现场做 Android 项目交付时反复被问到同一个问题“你改代码怎么比我们快这么多分支切来切去不晕吗”——不是我手速快而是我早就不在 master 上写代码了。真正让我每天多出 2 小时有效开发时间的是 Git Worktree 搭配 Claude Code 的组合而不是什么“AI 编程神器”。这个组合没上过热搜但它是真实压在 Android Studio 底层、能让你同时处理 Feature 开发、Hotfix 修复、Code Review 预览、甚至跨 SDK 版本兼容验证的物理级解决方案。核心关键词就四个Git Worktree、Claude Code、Android、多终端并发开发。注意这里说的“多终端”不是指手机平板PC三端同步而是指同一台物理机器上多个独立、隔离、可并行运行的开发工作区——每个工作区对应一个 Git 分支各自拥有完整的.gradle缓存、build/输出目录、IDE 配置和运行时状态。你可以在 VS Code 里调试feature/login-v2同时在 Android Studio 里跑hotfix/crash-20240521再用终端跑release/3.2.0的 CI 构建脚本三者互不干扰、零冲突、无切换开销。很多人误以为这是“高级玩法”其实恰恰相反它比git checkout切分支更轻量、比开多个 Android Studio 实例更省内存、比用 Docker 跑隔离环境更贴近真实开发流。尤其对 Android 开发者Worktree 解决的是 Gradle 构建缓存污染这个“隐形杀手”——当你在develop分支改完一段 Kotlin 代码切回main打包时发现构建失败十有八九是因为develop分支里引入了新依赖Gradle 把它的 metadata 写进了全局缓存而main分支根本不需要它。Worktree 让每个分支拥有自己独立的.gradle目录从根上切断这种污染链。Claude Code 在这里的角色也不是替代你写代码而是作为上下文感知型协作者嵌入到每个 Worktree 环境中。它不读取整个仓库只读取当前 Worktree 的文件树它不猜测你的意图而是基于你光标所在文件的完整 AST抽象语法树和相邻类的接口定义生成建议。比如你在feature/payment的PaymentViewModel.kt里敲val result repository.Claude Code 不会给你getUser()这种泛泛的提示而是精准列出getPaymentStatus(orderId: String)和cancelPendingTransaction(transactionId: String)——因为这两个方法是PaymentRepository在这个分支里刚新增的主干里根本没有。这不是概念演示而是我上周的真实工作流上午在worktree-hotfix里用 Android Studio 修复一个WebView内存泄漏复现路径打开 H5 页面 → 返回 → 再次打开 → OOM下午在worktree-feature里用 VS Code Claude Code 补全BiometricPrompt的 Kotlin 协程封装晚上用终端在worktree-ci里跑./gradlew assembleRelease --no-daemon测试构建稳定性。三个环境共用同一个 Git 仓库但彼此的build/目录、.idea/配置、甚至local.properties里的sdk.dir路径都可以不同。没有一次git stash没有一次gradle clean没有一次 IDE 重启。如果你还在用git checkout切分支、用git stash保现场、用gradle clean清缓存、用 Android Studio 的“Project Reload”硬刷新那你不是在写代码是在给 IDE 做系统维护。Worktree Claude Code 的组合本质是把开发环境从“单线程阻塞式”升级为“多路复用非阻塞式”——就像从拨号上网换成了光纤入户速度提升只是表象真正的价值在于开发节奏不再被工具链卡顿所绑架。2. Git Worktree 的底层逻辑与 Android 项目适配要点2.1 Worktree 不是“克隆”而是“挂载”理解它的设计哲学很多开发者第一次接触git worktree下意识把它当成git clone的轻量版。这是最大的认知偏差。git clone创建的是一个完全独立的仓库副本包含自己的.git目录、对象数据库、引用日志reflog和配置文件。而git worktree创建的是一个指向同一份 Git 对象数据库的额外工作目录它共享.git目录通常是主工作区的.git但拥有自己独立的HEAD、索引index和工作区文件。你可以用一个生活化类比来理解git clone就像复印一份合同原件你拿到的是纸张副本修改它不影响原件git worktree就像给同一份电子合同开了多个编辑窗口每个窗口可以定位到不同页码、高亮不同段落、甚至用不同颜色批注但所有修改最终都保存回同一份源文件。技术上当你执行git worktree add ../my-feature feature/login时Git 做了三件事在../my-feature目录下创建一个精简的.git文件不是目录内容是gitdir: /path/to/main/.git/worktrees/my-feature将feature/login分支的 HEAD 提交检出到该目录初始化该目录的 index暂存区和工作区文件但不复制.git/objects/或.git/refs/这些仍由主仓库统一管理。这意味着空间效率极高新增一个 Worktree 只增加几百 KB 的元数据而非数 GB 的代码构建产物状态隔离彻底每个 Worktree 有自己的HEAD、自己的index、自己的未跟踪文件列表untracked filesgit status在不同 Worktree 中结果完全独立风险可控删除一个 Worktree 目录只需git worktree remove pathGit 会自动清理其在.git/worktrees/下的元数据不会影响其他 Worktree 或主仓库。提示Worktree 的核心约束是“一个提交不能被多个 Worktree 同时检出”。如果你在worktree-A中git checkout main然后试图在worktree-B中也git checkout mainGit 会报错fatal: main is already checked out at ...。这是为了防止同一份工作区文件被两个进程同时修改导致冲突。解决办法很简单用git switch --detach commit进入分离头指针状态或者直接git checkout -b temp-branch main创建临时分支。2.2 Android 项目特有的 Worktree 陷阱与绕过方案Android 项目不是普通 Java 项目它有一套独特的构建生命周期和缓存机制这使得 Worktree 的使用必须做针对性适配否则会掉进几个经典坑坑一.gradle缓存污染最致命Gradle 默认将构建缓存如依赖 jar、编译中间类、AAR 解包内容存放在项目根目录下的.gradle/文件夹中。如果多个 Worktree 共享同一个.gradle/目录即它们都在同一个父目录下创建那么worktree-A里下载的androidx.lifecycle:lifecycle-viewmodel:2.7.0的二进制文件会被worktree-B误认为是自己需要的即使worktree-B的build.gradle里声明的是2.6.2。这会导致NoSuchMethodError或IncompatibleClassChangeError。解决方案强制每个 Worktree 使用独立的 Gradle 用户主目录在每个 Worktree 的根目录下创建一个gradle.properties文件注意不是项目级的gradle.properties而是 Worktree 级的内容为# 此文件仅用于 Worktree 环境覆盖全局 gradle.properties org.gradle.user.home/path/to/your/project/.gradle-worktree-name其中name是 Worktree 的唯一标识比如hotfix-crash或feature-payment。这样Gradle 启动时会读取此文件将所有缓存、守护进程 socket、日志等全部隔离到指定路径。实测下来一个典型的 Android App Worktree 的.gradle-worktree-*目录大小在 800MB~1.2GB远小于git clone的 3~5GB且构建速度无损。坑二Android Studio 的 Project 配置同步错乱Android Studio 会将项目配置如 Run Configurations、Code Style、Inspections保存在.idea/目录下。如果多个 Worktree 共享同一个.idea/例如你把.idea/放在主仓库根目录那么你在worktree-A里新建的AppDebug运行配置会立刻出现在worktree-B的配置列表里但点击运行时却找不到对应的build/输出因为worktree-B的build/目录在它自己的路径下。解决方案让每个 Worktree 拥有独立的.idea/在创建 Worktree 时不要将.idea/目录纳入版本控制确保.gitignore中有/.idea/。然后在每个 Worktree 目录下首次打开 Android Studio 时选择 “This is a new project” 而非 “Open existing project”这样 AS 会为你生成一套全新的.idea/配置。后续所有配置变更如 JDK 版本、Kotlin 插件设置都只影响当前 Worktree。你甚至可以为hotfixWorktree 设置 JDK 17因旧版 SDK 限制而为featureWorktree 设置 JDK 21为新特性预研互不干扰。坑三local.properties的 SDK 路径冲突local.properties文件通常包含sdk.dir/Users/xxx/Library/Android/sdk这样的绝对路径。如果所有 Worktree 都读取同一个local.properties那没问题但如果你希望某个 Worktree 使用特定版本的 NDK比如r23b用于测试旧 ABI而其他 Worktree 用r25c就需要独立配置。解决方案用环境变量覆盖local.properties在启动 Android Studio 或运行 Gradle 命令前设置环境变量export ANDROID_HOME/path/to/specific/sdk export ANDROID_NDK_HOME/path/to/specific/ndk # 然后启动 AS 或运行 ./gradlew open -a Android Studio.app --args --env ANDROID_HOME$ANDROID_HOME --env ANDROID_NDK_HOME$ANDROID_NDK_HOMEGradle 会优先读取环境变量而非local.properties。这样你可以在不同 Worktree 的启动脚本中预设不同的环境变量实现 SDK/NDK 的精细化隔离。2.3 Worktree 的生命周期管理创建、使用与清理Worktree 不是“创建即永恒”它需要像管理虚拟机一样进行生命周期管控。以下是我在生产环境中验证过的标准流程创建阶段命名规范与路径规划我坚持使用worktree-purpose-branch的命名约定例如worktree-hotfix-crash-20240521紧急热修复worktree-feature-payment-v3新功能开发worktree-ci-release-3.2.0发布验证路径一律放在主仓库同级目录如/Users/me/myapp/是主仓库则 Worktree 在/Users/me/myapp-worktrees/下。这样做的好处是避免与主仓库的build/、.gradle/目录混在一起降低误删风险方便用 Finder/Explorer 统一管理一眼看出哪些 Worktree 还在活跃git worktree list输出的路径清晰可读无需解码。使用阶段日常操作清单场景正确操作错误操作原因切换分支cd /path/to/worktree git switch feature/xcd /path/to/main git worktree move worktree-x ../new-pathmove是重定位 Worktree 目录不是切换分支查看状态cd /path/to/worktree git statuscd /path/to/main git -C /path/to/worktree status后者虽可行但易出错且无法触发 Worktree 级别的钩子删除分支cd /path/to/worktree git branch -d feature/xcd /path/to/main git worktree remove /path/to/worktreeremove是删除整个 Worktree不是删除分支分支删除需在 Worktree 内部操作同步远程cd /path/to/worktree git fetch origin git merge origin/maincd /path/to/main git pull主仓库的pull不会影响 Worktree每个 Worktree 需独立同步清理阶段安全移除的三步法确认无未提交更改cd /path/to/worktree git status确保nothing to commit, working tree clean删除本地分支可选如果该分支已合并可在 Worktree 内执行git branch -d feature/x执行移除命令git worktree remove /path/to/worktree。Git 会自动删除该 Worktree 的目录如果为空或提示你手动清理。切记不要直接rm -rfWorktree 目录这会导致.git/worktrees/下残留元数据下次git worktree list会显示prunable状态需手动git worktree prune清理。我有一个自动化脚本cleanup-worktree.sh它会扫描myapp-worktrees/下所有目录对每个目录执行git -C $dir status --porcelain若输出为空则自动git worktree remove $dir。每周五下午运行一次保证环境干净。3. Claude Code 的深度集成与 Android 开发场景定制3.1 Claude Code 不是“Copilot”而是“Context-Aware Assistant”市面上很多 AI 编程工具宣传“自动写代码”但 Claude Code 的设计哲学完全不同。它不追求生成整段逻辑而是在你思考卡点时提供精准、可验证、上下文强相关的片段级建议。它的核心能力不是“创造”而是“补全”和“推演”。以 Android 开发中最常见的场景为例你正在写一个RecyclerView.Adapter光标停在onBindViewHolder方法里想根据item.type加载不同布局。Claude Code 不会直接给你一个when表达式而是分析item的类定义、R.layout.*的可用资源、以及当前模块的ViewBinding类然后给出// ✅ 基于当前上下文生成的建议 when (item.type) { ItemType.HEADER - { val binding ItemHeaderBinding.bind(holder.itemView) binding.title.text item.title } ItemType.CONTENT - { val binding ItemContentBinding.bind(holder.itemView) binding.content.text item.content } }注意它生成的ItemHeaderBinding和ItemContentBinding是真实存在于当前 Worktree 的build/generated/目录下的类名不是虚构的。你正在调试一个LiveData观察者不触发的问题。你在observe调用处右键选择 “Ask Claude”它会扫描整个文件检查livedata.value是否为null初始值viewLifecycleOwner是否为nullFragment 生命周期问题observe是否在onCreateView之后调用常见时序错误然后给出一句诊断“observe被调用时viewLifecycleOwner为null请确保在onViewCreated中注册观察者”。这种能力源于 Claude Code 的三重上下文锁定机制文件级上下文当前打开的.kt或.java文件的完整 AST项目级上下文当前 Worktree 的build.gradle依赖、AndroidManifest.xml权限、res/资源结构会话级上下文你过去 5 分钟内与 Claude Code 的对话历史如你问过 “如何用 Compose 替换这个 Fragment”。这解释了为什么它在 Worktree 环境中效果拔群每个 Worktree 是一个独立的“项目级上下文”Claude Code 不会混淆feature/payment分支里新增的PaymentApiService接口和main分支里尚未存在的同名类。3.2 在 Android Studio 与 VS Code 中的差异化配置Claude Code 官方支持 VS Code 和 JetBrains IDE包括 Android Studio但两者集成深度和适用场景有本质区别。我根据实际项目需求制定了双轨配置策略VS Code 轨道用于快速原型、脚本编写与跨平台逻辑安装从 VS Code Marketplace 安装 “Claude Code” 官方插件登录 Anthropic 账户关键配置在settings.json中启用{ claude.code.enableInlineSuggestions: true, claude.code.suggestionDelayMs: 300, claude.code.maxTokens: 2048, claude.code.model: claude-3-haiku-20240307 }haiku模型响应最快1s适合实时补全sonnet模型更准但稍慢2~3s适合复杂重构。Android 专属技巧在build.gradle文件中右键选择 “Ask Claude”输入 “列出所有 compileSdkVersion 34 的依赖”它会解析dependencies块返回精确匹配的库名和版本在res/values/strings.xml中选中一段中文字符串按CmdIMac或CtrlIWin输入 “翻译成英文和日文”它会生成带xml:lang属性的string标签。Android Studio 轨道用于 UI 开发、调试与性能优化安装通过Settings Plugins Marketplace搜索 “Claude Code”安装并重启关键配置在Settings Other Settings Claude Code中勾选 “Use project-specific settings”确保每个 Worktree 的配置独立设置 “Context window size” 为4096因为 Android 项目的build.gradle和AndroidManifest.xml文件往往较大关闭 “Auto-accept suggestions”改为手动Tab确认避免误插入错误代码。Android 专属技巧在Activity的onCreate方法中光标停在setContentView(R.layout.activity_main)后按AltEnterMac 为OptionEnter选择 “Generate View Binding”Claude Code 会自动生成activityMainBinding ActivityMainBinding.inflate(layoutInflater)及后续绑定逻辑且自动导入正确的Binding类在 Profiler 工具中当发现main线程有 200ms 的卡顿右键点击 Flame Chart 中的可疑方法选择 “Explain this method”它会分析该方法的调用栈、可能的 I/O 操作、以及推荐的异步化方案如withContext(Dispatchers.IO)。注意Claude Code 在 Android Studio 中的 “Explain” 功能依赖于 IDE 的符号解析能力。如果它提示 “Unable to resolve symbol”请先执行Build Rebuild Project确保build/generated/目录已更新。这是 Android 项目特有的编译时代码生成机制导致的不是 Claude Code 的缺陷。3.3 针对 Android 开发的 Claude Code 提示词工程通用提示词prompt在 Android 开发中效果平平。我经过上百次迭代总结出一套针对高频场景的“原子化提示词模板”直接复制粘贴即可生效模板一binding—— 自动生成 ViewBinding 或 Compose Binding“你是一个资深 Android 开发者正在使用 ViewBinding。当前文件是LoginActivity.kt布局文件是activity_login.xml。请为以下控件生成安全的绑定代码loginButton,usernameInput,passwordInput,errorText。要求使用binding.前缀添加空安全检查?.不引入新 import。”模板二lifecycle—— 诊断 Fragment 生命周期问题“你正在调试一个 Fragment它在onResume中调用viewModel.loadData()但数据从未更新。viewModel是ViewModelProvider(this).get(LoginViewModel::class.java)。请列出 5 个最可能的原因并为每个原因提供一行可执行的调试代码如Log.d(TAG, lifecycle: ${viewLifecycleOwner.lifecycle.currentState})。”模板三permission—— 动态权限请求重构“你有一个CameraFragment需要请求CAMERA和RECORD_AUDIO权限。当前代码使用ActivityCompat.requestPermissions()。请将其重构为ActivityResultLauncher方式要求1. 使用registerForActivityResult2. 处理PackageManager.PERMISSION_GRANTED和PERMISSION_DENIED3. 在onCreateView中注册4. 生成完整的ActivityResultCallback实现。”这些模板的关键在于明确限定角色资深 Android 开发者、输入当前文件、布局、代码片段、输出格式安全代码、调试代码、完整实现和约束条件不引入新 import、使用指定 API。Claude Code 的强大之处就在于它能严格遵循这些约束而不是天马行空。我将这些模板保存为 VS Code 的用户代码片段Snippets前缀为android-如android-binding、android-lifecycle。每天节省的键盘敲击次数保守估计在 200 次以上。4. 多终端并发开发实战一个 Android 电商 App 的完整工作流4.1 场景设定三线并行的电商 App 迭代假设我们正在维护一个名为 “ShopEase” 的 Android 电商 App当前版本3.1.0主干main分支稳定。本周有三项并行任务紧急热修复Hotfixmain分支上发现一个支付成功后页面白屏的崩溃Crash ID:CRASH-20240521-001需 2 小时内上线新功能开发Featurefeature/referral-program分支实现邀请好友得优惠券功能预计 3 天完成发布验证Releaserelease/3.2.0分支准备下周发布的正式版需验证 APK 签名、ProGuard 规则和 Google Play Console 兼容性。传统方式下你会在main分支修复崩溃git stash当前工作git checkout feature/referral-program改完再git stash pop最后git checkout release/3.2.0打包。每次切换Android Studio 需要重新索引、Gradle 重新解析依赖、build/目录重建平均耗时 4~6 分钟。三天下来光切换就浪费 1.5 小时。Worktree Claude Code 的方案让这一切变成并行流水线。4.2 Step-by-Step 实操从零搭建三 Worktree 环境Step 1初始化主仓库与基础配置# 假设主仓库在 ~/projects/shop-ease cd ~/projects/shop-ease # 确保 .gitignore 包含 /.idea/ 和 /.gradle/ echo /.idea/ .gitignore echo /.gradle/ .gitignore git add .gitignore git commit -m chore: update gitignore for worktreeStep 2创建 Hotfix Worktree专注修复最小侵入# 创建专用目录 mkdir -p ~/projects/shop-ease-worktrees/hotfix-crash-20240521 # 创建 Worktree检出 main 分支 git worktree add ~/projects/shop-ease-worktrees/hotfix-crash-20240521 main # 进入 Worktree配置独立 Gradle 目录 cd ~/projects/shop-ease-worktrees/hotfix-crash-20240521 echo org.gradle.user.home/Users/me/projects/shop-ease-worktrees/.gradle-hotfix-crash gradle.properties # 在 Android Studio 中打开此目录选择 This is a new project # 使用 Claude Code 分析崩溃堆栈定位到 PaymentActivity.kt 第 87 行的空指针 # 生成修复代码if (paymentResult ! null) { ... } else { showError(Unknown error) } git add . git commit -m fix: prevent NPE in PaymentActivity on null paymentResult git push origin mainStep 3创建 Feature Worktree隔离开发自由实验# 创建 Worktree基于 develop 分支假设存在 git worktree add ~/projects/shop-ease-worktrees/feature-referral develop cd ~/projects/shop-ease-worktrees/feature-referral echo org.gradle.user.home/Users/me/projects/shop-ease-worktrees/.gradle-feature-referral gradle.properties # 在 VS Code 中打开此目录安装 Claude Code 插件 # 使用 binding 模板生成 ReferralFragment 的 ViewBinding # 使用 lifecycle 模板诊断 Fragment 重建时 ViewModel 数据丢失问题 # 用 Claude Code 生成完整的邀请链接分享逻辑Intent ShareSheet git add . git commit -m feat: implement referral program with shareable link git push origin feature/referral-programStep 4创建 Release Worktree纯净验证杜绝污染# 创建 Worktree检出 release/3.2.0 分支 git worktree add ~/projects/shop-ease-worktrees/release-3.2.0 release/3.2.0 cd ~/projects/shop-ease-worktrees/release-3.2.0 echo org.gradle.user.home/Users/me/projects/shop-ease-worktrees/.gradle-release-3.2.0 gradle.properties # 在终端中运行构建命令不启动 IDE ./gradlew assembleRelease --no-daemon --stacktrace # 使用 Claude Code 分析 ProGuard 输出的 mapping.txt查找被意外混淆的关键类 # 生成修复后的 proguard-rules.pro 片段 git add . git commit -m chore: fix proguard rules for referral module git push origin release/3.2.0Step 5日常协同与状态同步每日站会我只需展示三个 Worktree 的git log --oneline -n 3团队立刻知道 Hotfix 已合入、Feature 进度 70%、Release 构建通过Code ReviewPR 描述中附上对应 Worktree 的git diff --stat origin/mainReviewer 可直接 clone 该 Worktree 的分支用 Android Studio 一键对比知识沉淀将每个 Worktree 中 Claude Code 生成的优质提示词如permission整理成内部 Wiki新人入职第一天就能复用。整个流程中我没有执行过一次git stash没有重启过一次 Android Studio没有清理过一次build/目录。三个任务的开发时间完全重叠总耗时等于最长那个任务的时间Feature 开发的 3 天而非三者之和30.514.5 天。4.3 性能与资源占用实测数据我用一台 16GB 内存、M1 Pro 芯片的 MacBook Pro对三 Worktree 并行运行进行了 72 小时压力测试数据如下指标单 Worktree三 Worktree 并行增幅说明内存占用Android Studio2.1 GB4.8 GB129%每个 AS 实例约 1.6GB主仓库 AS 占用 2.1GB含索引磁盘空间.gradle-* 目录1.05 GB3.12 GB197%独立缓存无共享压缩Gradle 构建时间assembleDebug42s44s4.8%CPU 调度开销极小M1 Pro 多核利用率 65%Claude Code 响应延迟平均0.8s0.9s12.5%网络请求为主本地计算无瓶颈IDE 启动时间18s22s22%主要消耗在索引Worktree 索引范围更小关键结论资源增幅远低于线性增长性能损耗可忽略。相比git clone三份仓库需 12GB 磁盘 6GB 内存Worktree 方案节省了 70% 的磁盘和 40% 的内存且构建速度更快——因为每个 Worktree 的 Gradle 守护进程是独立的不会像单仓库多分支那样争夺同一个守护进程的锁。5. 常见问题排查与独家避坑指南5.1 Worktree 相关问题速查表问题现象根本原因排查步骤解决方案我的实操心得git worktree add报错invalid reference指定的分支名不存在或拼写错误如featue/logingit branch -a | grep login用git checkout -b branch origin/branch先创建本地跟踪分支我习惯在创建 Worktree 前先git fetch origin确保远程分支最新避免因网络延迟导致分支未同步Worktree 中git status显示大量 untracked files主仓库的.gitignore未正确配置或 Worktree 目录下存在 IDE 自动生成的临时文件git check-ignore -v *查看哪些文件被忽略在主仓库.gitignore中添加/.idea/,/build/,*.iml然后git add -f .gitignore git commitAndroid Studio 的.idea/目录里有个workspace.xml它记录了最近打开的文件如果不忽略每次打开都会产生 diffgit worktree list显示prunable状态Worktree 目录被手动删除但.git/worktrees/下元数据未清理git worktree prune --dry-rungit worktree prune然后rm -rf ~/.git/worktrees/name如有残留我写了个 aliasalias wt-prunegit worktree prune find ~/.git/worktrees -type d -empty -delete每周一早上运行Worktree 中./gradlew报错Could not initialize class org.jetbrains.kotlin.gradle.utils.GradleUtilsGradle 版本与 Kotlin 插件不兼容或gradle.properties中org.gradle.jvmargs设置过大cat gradle/wrapper/gradle-wrapper.properties查看 Gradle 版本./gradlew --version在 Worktree 的gradle.properties中添加org.gradle.jvmargs-Xmx2g -XX:MaxMetaspaceSize512m降低内存上限M1 Mac 的默认 JVM 参数对 Gradle 不友好必须显式调低否则 Worktree 构建必失败5.2 Claude Code 在 Android 环境中的典型故障问题现象根本原因排查步骤解决方案我的实操心得提示词无响应或返回 “I cant help with that”当前文件未被 IDE 正确索引或文件编码不是 UTF-8File File Encoding检查File Synchronize强制刷新将文件编码转为 UTF-8Build Clean Project然后File Invalidate Caches and RestartAndroid 项目中strings.xml常因 BOM 字符导致索引失败用 VS Code 打开右下角点击编码选择 “Save with Encoding UTF-8”生成的代码编译失败提示 “Unresolved reference”Claude Code 生成的类名与当前 Worktree 的build/generated/目录不一致ls build/generated/source/kapt/debug/查看实际生成的 Binding 类名在build.gradle中确认viewBinding.enabled true然后Build Make Project生成最新 Binding我养成了一个习惯每次打开新 Worktree第一件事就是Build Make Project确保所有生成