Source Insight怎么创建工程 Source Insight工程创建失败怎么办

拿到一份源码，直接打开文件虽然能看内容，但跨文件查找函数、梳理调用关系时，还是需要建立工程。有时工程名称已经填好，确认后却提示无法写入；也有工程能打开，文件列表里却没有代码。这两种情况要分开判断。Source Insight需要保存工程数据，也需要把源码加入索引，目录设置、文件筛选和解析状态都会影响结果，不能只看工程窗口有没有出现。

一、Source Insight怎么创建工程

下面以Source Insight 4英文界面为例。这里创建的是用于阅读和检索代码的工程，不会代替编译工具生成程序，也不要求源码目录里已有某种开发环境的工程文件。

1、填写工程名称和数据保存位置

工程数据目录与源码目录可以分开。代码放在共享目录、当前账号只有读取权限时，可以把索引数据留在本机，不必往源码目录里写入工程文件。

①点击【Project】→【New Project】，在【New project name】中输入工程名称，不在名称栏填写完整路径。

②在【Where do you want to store the project data files?】中指定本地可写目录，确认后进入工程设置。

③在【Project Source Directory】中填写源码根目录，核对路径后点击【OK】。

2、将源码加入工程

①打开【Project】→【Add and Remove Files】，在目录列表中定位需要阅读的源码。

②只添加少量文件时，选中文件点击【Add】；添加整个源码目录时，定位对应目录后点击【Add Tree】。

③查看【Project Files List】，核对已加入的文件，点击【Close】关闭窗口。

填写源码根目录，不等于所有文件已经加入工程。文件列表为空时，应回到添加窗口检查。工程通常只需加入源码和相关文本文件，程序文件、图片及编译产物没有必要一起纳入。

3、同步源码并检查解析结果

文件加入后，软件会解析其中的函数、类型和其他符号。较大的代码库可能还在后台处理，刚建好工程就搜索某个函数，结果暂时不完整并不稀奇。

①点击【Project】→【Synchronize Files】，执行工程同步。

②需要重新解析全部工程文件时，勾选【Force all files to be re-parsed】，再启动同步。

③在【Project File List】中打开一个已知源码文件，查看【Symbol Window】中是否显示函数或类型。

二、Source Insight工程创建失败怎么办

排查时保留完整报错，并记住它出现在哪一步。新建时无法写文件，与添加源码后解析不完整，处理方式不同。

1、提示无法创建文件，检查保存目录

①在Windows文件资源管理器中打开工程数据目录，右键进入【属性】→【安全】，检查当前账号的写入权限。

②返回【Project】→【New Project】，将工程数据保存位置改到当前用户可写的本地文件夹，使用新的工程名称测试。

③源码位于共享目录时，在【Project Source Directory】中保留源码路径，将工程数据存到本地。

能读取源码，只能说明源码访问正常，不能证明工程数据目录也能写入。如果换到本地目录后能够创建，应继续核查原位置的权限和访问状态，不必因此移动整份代码。

2、工程里没有文件，检查筛选设置

源码目录选对了，部分扩展名却没有被收进来，往往要看文件类型配置。某些项目使用自定义后缀，默认筛选规则未必包含它们。

①打开【Project】→【Add and Remove Files】，核对目录位置及【Show only known file types】设置。

②点击【Options】→【File Type Options】，选择对应类型，在【File Filter】中补充实际使用的扩展名，例如【*.inc】。

③勾选【Include when adding to project】，返回添加窗口，重新执行【Add Tree】。

④在【Project Files List】中找到一份此前遗漏的文件，确认后关闭窗口。

3、添加源码后长时间没有完成，缩小范围测试

①新建测试工程，在【Add and Remove Files】中先选择一个较小的源码子目录，点击【Add Tree】。

②测试正常后，分批加入其余源码目录，核对每次增加的文件范围。

③在【Project Settings】中检查【Quick browsing for member names】与【Quick browsing for symbol name fragments】，大型工程按检索需要调整这两项索引。

索引项越多，需要的磁盘与内存资源也会增加。关闭相关选项会改变部分符号检索方式，不能只为缩短处理时间随意取消。分批添加还方便发现误收进来的生成目录和大批无关文件。

4、异常退出后工程打不开，按提示重建数据

①出现工程损坏提示时，按重建提示处理；工程仍能打开时，点击【Project】→【Rebuild Project】。

②怀疑数据库损坏时，选择【Fix database file corruption,if any】；需要重新生成全部符号数据时，选择【Re-Create the whole project from scratch】。

③重建完成后打开已知源码文件，核查符号；中途取消过重建时，再执行【Project】→【Synchronize Files】。

重建针对工程数据库，不能修复丢失的源码。若源文件本身已经被移动或删除，应恢复文件或修正路径，反复重建索引不会把代码找回来。

三、Source Insight工程建好后怎样避免文件和索引脱节

工程能打开后，还要留意代码更新带来的变化。切换分支、增加目录或移动仓库，都可能让原来的文件清单与当前源码不一致。

1、新增文件没有出现，明确检查添加范围

自动添加有目录范围限制，并不会无条件扫描磁盘上的所有新文件。全新目录没有被纳入时，手动添加更便于确认范围。

①打开【Project】→【Synchronize Files】，按需启用【Add new files automatically】，执行同步。

②新目录仍未出现时，进入【Project】→【Add and Remove Files】，定位该目录，点击【Add Tree】。

③回到【Project File List】，打开新增文件，核对内容与实际目录中的文件一致。

2、代码位置变化后，核对根目录和实际文件

①点击【Project】→【Project Settings】，检查【Project Source Directory】是否仍指向当前源码根目录。

②打开【Add and Remove Files】，核对工程文件路径，移除失效条目，再加入正确位置的源码。

③执行【Project】→【Synchronize Files】，打开几个已知文件，检查函数定义及关联位置。

仅修改源码根目录设置，不应直接理解为所有旧文件路径都会自动修好。目录调整后要检查实际打开的是哪份代码，尤其是电脑里同时保留多个分支副本时，同名文件很容易让人看错。

总结

Source Insight工程的作用，是让一组源码能够持续地被检索和关联。工程数据放在稳定可写的位置，文件清单保持清楚，日常阅读会省去不少反复定位的时间。代码更新后若发现跳转异常，也应结合实际文件检查，避免对着旧副本分析问题。希望这些方法能帮大家顺利建立工程，如有相关需求，欢迎沟通了解。