迁移至Angular 17后，依赖库变更未生效的问题排查

1. 确保类库以开发模式监听构建 #

Angular 17默认的类库构建会启用生产优化，修改代码后不会实时同步到dist目录。在类库工作区执行：

ng build my-lib --watch --development

--development参数会关闭代码压缩、tree-shaking等优化，保证修改后的代码实时输出到dist目录。

2. 让Angular应用监听符号链接文件 #

Angular 17的构建工具默认可能忽略符号链接（symlink）文件的变化，需要在angular.json中调整应用的构建配置：
打开项目的angular.json，找到对应应用的architect.build.options，添加：

"watchOptions": {
  "followSymlinks": true
}

如果需要精准指向你的类库，也可以用：

"watchOptions": {
  "ignored": "!**/node_modules/@my-scope/my-lib/**"
}

3. 禁用Vite缓存 #

Angular 17默认使用Vite作为开发服务器，它的缓存机制可能导致symlink文件的修改不被检测到。在angular.json的应用architect.serve.options中添加：

"vite": {
  "cacheDir": false
}

4. 清理TypeScript路径映射 #

如果你的tsconfig.json中配置了@my-scope/my-lib的本地路径映射，会绕开node_modules的symlink直接读取源文件，导致更新异常。移除compilerOptions.paths里类似的配置：

// 删掉这一行配置
"@my-scope/my-lib": ["../my-lib/src/public-api"]

5. 重启服务并强制刷新 #

完成上述配置后完全关闭当前的开发服务器，重新启动ng serve，然后在浏览器中按Ctrl+Shift+R强制刷新，清除浏览器缓存。

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