Angular 12/13本地库组件渲染报错：Cannot read 'bindingStartIndex'

• 清理模块解析冲突
  不要同时使用tsconfig.json的paths映射和package.json的file:依赖，二者选其一：如果保留file:依赖，就删除paths中的对应配置，避免Angular模块解析时出现歧义。

• 对齐编译配置与依赖版本

  • 确保本地库的tsconfig.lib.json中compilerOptions.target与主应用完全一致（比如均设为ES2020）
  • 检查库的package.json里@angular/core、@angular/common等核心依赖版本，必须和主应用保持相同，执行npm ls @angular/core可排查依赖树中的版本差异

• 彻底清理缓存并重新编译

  1. 执行ng clean清除Angular缓存
  2. 删除主应用和库目录下的node_modules、dist文件夹
  3. 重新安装依赖：npm install
  4. 先编译本地库：ng build your-library-name，再启动主应用：ng serve

• 排查模板语法细节
  即使组件代码和主应用完全一致，库编译时的模板校验规则可能更严格：

  • 检查模板中是否存在未初始化的变量绑定，比如{{ item.name }}需改为{{ item?.name }}避免空值访问
  • 确认没有重复的结构指令（如*ngIf、*ngFor）或未闭合的HTML标签

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