检查旧项目的残留依赖,核心是找出那些已经不再参与构建、运行或页面输出,却仍留在代码、配置或数据里的引用。对“pr值”这类历史概念而言,重点是核查它是否还出现在模板变量、数据表字段、前端脚本或统计代码中,而不是重新追求一个早已失去官方来源的数值。适用前提是:项目仍能运行,你能拿到代码、配置和数据库的只读权限。验收信号是:删除或隔离后,构建通过、页面正常、没有新的报错。
残留依赖不等于出现即有害。判断依据有三个:
package.json、composer.json、requirements.txt等依赖清单,以及构建脚本、打包配置里是否还挂着相关模块。如果一项只在注释、文档或历史提交记录里出现,可归为“文字残留”,优先级低于运行依赖。
假设一个旧站点模板里曾输出过类似<span class="pr">...</span>的结构,可以按以下步骤执行:
node_modules、vendor、.git等目录,记录命中的文件路径和行号。判断结果时注意:搜索不到不代表没有动态拼接。变量名可能由字符串拼接生成,这时需要结合运行日志和实际页面输出验证。
隔离或删除后,按下面清单验收:
如果页面依赖一个已经无人维护的外部数值来源,正确做法不是继续保留调用,而是把展示逻辑改为读取本地可控字段,或直接移除该展示位。这样能避免外部来源变化时页面出现空白或错误。
一次清理完成后,把关键词、搜索范围、排除目录和验收命令写进项目说明或检查脚本。下次改动前先跑一遍,能快速判断新引入的引用是否属于残留。对于历史概念相关的字段,建议在数据字典中标注“已废弃”及替代字段,避免后来者重新接入。
下一步:选一个当前仍在运行的旧页面,按上面的搜索、分组、隔离、验收四步做一次小范围清理,并记录删除前后的构建与页面表现差异。