fix(babel-preset-taro): list组件转换避免导入命名冲突

[Single-Dancer]

这个 PR 做了什么？ (简要描述所做更改)
list组件转换避免导入命名冲突

这个 PR 是什么类型？ (至少选择一个)

• 错误修复 (Bugfix) issue: fix #
• 新功能 (Feature)
• 代码重构 (Refactor)
• TypeScript 类型定义修改 (Types)
• 文档修改 (Docs)
• 代码风格更新 (Code style update)
• 构建优化 (Chore)
• 其他，请描述 (Other, please describe):

这个 PR 涉及以下平台：

• 所有平台
• Web 端（H5）
• 移动端（React-Native）
• 鸿蒙（Harmony）
• 鸿蒙容器（Harmony Hybrid）
• ASCF 元服务
• 快应用（QuickApp）
• 所有小程序
• 微信小程序
• 企业微信小程序
• 京东小程序
• 百度小程序
• 支付宝小程序
• 支付宝 IOT 小程序
• 钉钉小程序
• QQ 小程序
• 飞书小程序
• 快手小程序
• 头条小程序

Summary by CodeRabbit

发布说明

• 优化

  • 改进了 Taro 组件导入处理机制，提升了导入管理的可靠性，减少命名冲突风险。

• 杂项

  • 更新了项目配置文件忽略规则。

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

概览

此拉取请求包含两个主要变更：更新 .gitignore 配置以添加新的忽略模式，以及重构 Babel 预设中的 Taro 组件导入管理，从全局状态改为基于文件的状态管理，并增强组件本地名称解析逻辑。

变更内容

群组 / 文件	变更摘要
配置文件 \.gitignore	新增 .claude、.trae 和 .kiro 忽略模式至 Node Addons 部分；Chrome 条目后添加空行
Babel 插件重构 packages/babel-preset-taro/transform-taro-components.js	引入基于文件的状态管理（state.taroComponentImports 和 state.generatedImports）替代全局 componentImports；新增 hasTargetTaroComponent 和 getComponentLocalName 辅助函数；改进 ImportDeclaration 和 JSXElement 处理以使用动态本地名称解析；确保组件名称唯一性避免命名冲突

代码审查工作量评估

🎯 3 (Moderate) | ⏱️ ~25 分钟

建议审阅者

• tutuxxx
• yoyo837

诗

🐰 ✨
组件的名字不再纷争，
状态管理新生光芒，
本地名称各得其所，
导入重构走向远方，
冲突消散如梦幻泡。

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR标题准确地总结了主要变更：修复babel-preset-taro中list组件转换的导入命名冲突问题，与代码变更内容高度一致。

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/transform-list

---

---

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 032fbed and 76730e4.

📒 Files selected for processing (2)

• .gitignore
• packages/babel-preset-taro/transform-taro-components.js

🧰 Additional context used

🧠 Learnings (3)

📚 Learning: 2025-08-25T22:16:50.118Z

Learnt from: ianzone
Repo: NervJS/taro PR: 18150
File: packages/babel-plugin-transform-taroapi/tests/__mocks__/h5-definition.json:2356-2356
Timestamp: 2025-08-25T22:16:50.118Z
Learning: The file `packages/babel-plugin-transform-taroapi/tests/__mocks__/h5-definition.json` is auto-generated by the post-build script `packages/taro-platform-h5/scripts/post-build.mjs`, which copies content from `taro-platform-h5/dist/definition.json`. This file should not be manually edited.

Applied to files:

• packages/babel-preset-taro/transform-taro-components.js

📚 Learning: 2025-05-25T18:02:31.387Z

Learnt from: ianzone
Repo: NervJS/taro PR: 17746
File: packages/taro-runtime/tsdown.config.ts:10-16
Timestamp: 2025-05-25T18:02:31.387Z
Learning: 在 taro-runtime 包的 tsdown 配置中，必须禁用 treeshake 来保留 dom-external/index.js 文件。

Applied to files:

• packages/babel-preset-taro/transform-taro-components.js

📚 Learning: 2025-09-05T18:40:45.775Z

Learnt from: ianzone
Repo: NervJS/taro PR: 18150
File: packages/taro-platform-harmony-hybrid/package.json:43-45
Timestamp: 2025-09-05T18:40:45.775Z
Learning: 在 tarojs/plugin-platform-harmony-hybrid 包中，tarojs/components-library-react、tarojs/components-library-solid 和 tarojs/components-library-vue3 必须作为直接依赖（dependencies）而不能作为 peer 依赖，因为插件源码中有对这些包的直接引用，包括 componentAdapter* getter 方法和 webpack 别名配置。

Applied to files:

• packages/babel-preset-taro/transform-taro-components.js

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)

• GitHub Check: Build Rust Binding / stable - x86_64-pc-windows-msvc
• GitHub Check: Build Rust Binding / stable - aarch64-unknown-linux-gnu
• GitHub Check: Build Rust Binding / stable - x86_64-unknown-linux-gnu
• GitHub Check: Build Rust Binding / stable - x86_64-pc-windows-msvc

🔇 Additional comments (6)

.gitignore (1)

89-92: LGTM!

新增的 AI 工具目录忽略规则（.claude、.trae、.kiro）是合理的，可以避免将 AI 辅助工具的本地配置文件提交到版本库。

packages/babel-preset-taro/transform-taro-components.js (5)

36-53: LGTM!

辅助函数设计合理：

• hasTargetTaroComponent 用于检查目标组件是否存在
• getComponentLocalName 通过 generateUidIdentifier 生成唯一标识符，有效避免命名冲突，并通过 generatedImports 缓存确保同一组件在整个转换过程中使用一致的本地名称

---

67-71: LGTM!

在 Program.enter 中初始化每个文件独立的状态是正确的做法，避免了跨文件状态污染问题。

---

72-134: 导入重建逻辑正确，但需注意导入顺序变化。

整体逻辑清晰：收集所有 @tarojs/components 的导入说明符，过滤掉 List 和 ListItem，并通过 ensureSpecifier 补充转换所需的组件。specifierMap 使用 local.name 作为 key 可以正确避免重复的本地名称。

需要注意的是，Line 127 使用 unshift 将重建的导入声明放置在文件顶部，这可能会改变原有的导入顺序。对于 @tarojs/components 通常不会有副作用问题，但如果后续有其他场景需要考虑导入顺序敏感的情况，建议留意。

---

136-160: LGTM!

ImportDeclaration 访问器正确地将组件导入信息收集到 state.taroComponentImports 中，添加的 packageName === TARO_COMPONENTS 判断条件确保只收集来自 @tarojs/components 的导入，这是修复导入命名冲突的关键。

---

161-222: LGTM!

JSX 转换逻辑正确：

• 使用 hasTargetTaroComponent 检查组件是否存在
• 通过 getComponentLocalName 获取动态解析的组件本地名称，确保生成的 JSX 使用正确的组件引用
• List → ScrollView + ListBuilder 的转换结构和 ListItem → View 的转换都正确使用了解析后的本地名称

_{✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 56.32%. Comparing base (032fbed) to head (76730e4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff            @@
##             main   #18750    +/-   ##
========================================
  Coverage   56.32%   56.32%            
========================================
  Files         447      447            
  Lines       23345    23345            
  Branches     5796     5797     +1     
========================================
  Hits        13149    13149            
- Misses       8368     8502   +134     
+ Partials     1828     1694   -134     

Flag	Coverage Δ
taro-cli	72.85% <ø> (ø)
taro-runtime	60.27% <ø> (ø)
taro-web	53.12% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 43 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.