开放原子开发者工作坊

0. 在吹牛之前，先回答这个问题： 如果你的团队来了一个新队员，有一台全新的机器， 你们是否有一个文档，只要设置了相应的权限，她就可以根据文档，从头开始搭建环境，并成功地把最新、最稳定版本的软件编译出来，并运行必要的单元测试？ （在这过程中，不需要和老队员做任何交流）

---

 

　　我们团队采用TFS来进行源代码管理，以及VS2013进行开发，由于我们是进行数据的处理，不同于web服务器的搭建，我们对于环境的配置以及搭建没有特殊的要求，主要是集中于对于TFS的使用以及VS的操作，所以我们能够保证在新加入队员的情况下仍然能够把源码编译出最后稳定的发布版并且可以运行必要的单元测试而不需要和老的队员做任何交流。

 

1. 你的团队的源代码控制在哪里？用的是什么系统？ 如何处理文件的锁定问题？

   场景：  程序员果冻正在对几个文件进行修改，实现一个大的功能， 这时候， 程序员小飞也要改其中一个文件，快速修复一个问题。怎么办？

    一个代码文件被签出 (check out) 之后，另一个团队成员可以签出这个文件，并修改，然后签入么？有几种设计，各有什么优缺点？例如，签出文件后，此文件就加锁，别人无法签出；  或者， 所有人都可以自由签出文件

---

　　

　　对于TFS的签入签出产生的冲突通过团队内规范来解决，具体方法如下：

1. 开始工作前的行为（每天开始工作先签出代码）
   • 根据需要，签出你所需要修改的代码（注：在签出代码时，你的签出文件会和服务器同步）不要签出所有代码
   • 修改代码时，不要改动你签出文件中他人的方法，如必需改动的，请与该方法作者协商
   • 方法体不要太长，尽量不要超过20行，多进行重构
   • 当一个方法完成时，请马上构建单元测试，并测试通过
   • 单元测试需可重复测试，不要出现只能测试一次，下次测试必须修改数据库才能再测试的问题
2. 每日签入的行为（每天需签入当日全部开发代码）签入步骤：
   • 签入代码前先选择“获取服务器上最新版本（递归）”（不会对你的已签出文件覆盖）
   • 编译解决方案下所有工程
   • 解决编译冲突
   • 运行单元测试
   • 提交签入你的签出文件
3. 版本控制行为（代码commit的要求和发生冲突的解决办法）
   • 出现冲突时自动合并
   • 自动合并解决不了的请选择解决按钮，选择手工合并
4. 注意事项

• 打开解决方案时在网络环境允许的情况下一定要连接团队开发服务器
• 禁止用Ctrl+A 后再到其它文件中用Ctrl+C 、Ctrl+V的方式回写覆盖代码
• 签入代码时请在说明栏写简单说明
• 签入代码时关联有效工作项，并根据当前情况选择“关联”或“解决” 

 

2. 如何看到这个文件和之前版本的差异？ 如何看到代码修改和工作项 （work item），缺陷修复 （bug fix) 的关系。

   场景： 程序员果冻看到某个文件被修改了，他怎么看到这个文件在最近的修改究竟改了哪些地方？ 

   场景： 程序员果冻看到某个文件在最新版本被改动了100 多行， 那么和这100多行对应的其他修改在什么文件中呢？ 这个修改是为了解决哪些问题而作的呢？ 那些问题有工作项 （work item，issue），或者bug 来跟踪么？

 

3. 如果某个文件在你签出之后已经被别人修改，并且签入了，那么你在签入你的修改的时候， 如何合并不同的修改（merge)? 你用了什么工具来帮助你？

---

 

　　这种情况通常不会发生，我们的任务计划制定的较为合理，尽量保证每个成员的代码分工是明确的，尽量将一段时间内的工作安排不同人操作不同的代码，即不会让两个人同时修改同一个文件中的代码，来避免产生冲突，这样即使有冲突也都在可以接受的范围之内。如果出现该情况，首先考虑自动合并，对于无法自动合并的则需要人工的来合并以解决冲突。

 

4. 你有20个文件都是关于同一个功能的修改，你要如何保证这些文件都 同时签入成功（修改的原子性），或者同时签入不成功？

    场景： 程序员果冻要签入 20 个文件，他一个一个地签入， 在签入完5 个 .h 文件之后， 他发现一些 .cpp 文件和最新的版本有冲突，他正在花时间琢磨如何合并... 这时候， 程序员小飞从客户端同步了所有最新代码， 开始编译， 但是编译不成功 - 因为有不同步的 .h 文件和 .cpp 文件！  这时候， 别的程序员也来抱怨同样的问题，果冻应该怎么办？

---

　　

　　 这个问题我们是这么解决的：在获取之前先保证自己的能编译通过，保证自己不出问题，然后在获取其他人的更改，解决冲突后再编译，验证其他人的更改，如果编译通过则签入，如果编译失败，发现是某个人的提交未完成时候，找到他解决提交问题之后，再重复获取编译直至通过后再签入。并且所有人都遵循这个约定。

 

 

5. 你的PC 上有关于三个功能的修改，但是都没有完成，有很多文件处于半完工的状态，这时你要紧急修改一个新的 bug，如何把本地修改放一边，保证在干净的环境中修改这个 bug, 并成功地签入你的修改 --- changelist management。

---

　　

　　这个问题在大型软件开发中可能会涉及，在我们的软件开发过程中，还没有遇到过这种问题，所以暂时未进行考虑。

 

6. 如何给你的源代码 建立分支？

    场景：你们需要做一个演示，所以在演示版本的分支中对各处的代码做了一个临时的修改， 同时，主要的分支还保持原来的计划开发。 你们怎么做到的？ 在演示之后，演示版本的有些修改应该合并到主分支中，有些则不用，你们是怎么做到的？

    场景： 你们的软件发布了，有很多用户，一天，一个用户报告了一个问题，但是他们是用某个老版本，而且没有条件更新到最新版本。 这时候，你如何在本地构建一个老版本的软件，并试图重现那个问题？

---

 　　

在Visual Studio中进行分支操作，十分方便，首先我们创建一个分支：

• 在源代码管理器窗口中，选中一个要对其进行分支的项目，然后右键点击选择“分支”，在这里，可以选择分支的名称、对主分支的最新版本还是指定版本进行分支，是否创建新分支的本地副本（也就是将新分支从TFS服务器上下载到本地工作区中）
• 点击确定按钮后，开始创建分支的操作，创建成功后，我们在源代码管理器窗口中，可以看到主分支和新分支之间有一个双向箭头的图标表示了它们的关系。

• 先试着在新的分支中修改一下代码，然后签入修改，接下来我们演示合并分支的操作：在源代码管理器窗口中，选择一个分支，将其合并到主分支，右键点击后，选择“合并”。

• 在源代码管理合并向导中，选中的分支作为源分支，目标分支会自动被识别出来，点击下一步按钮，向导会提示你，选择源分支的哪个版本进行合并，确定以后，向导提示你可能需要解决冲突，点击完成按钮，如果合并的分支之间有冲突，则会提示你要先解决冲突后，才能合并。点击解决按钮，提示*.cs文件存在冲突。
• 点击比较按钮，在比较窗口中，会显示两个分支中，同一个文件的差异，选择“在合并工具中合并修改”，并点击确定按钮，后台会为你启动合并工具，稍等片刻，在合并工具中可以选择一边的更改加以应用，如果有多个不一致的地方，则可以通过“上一个更改”和“下一个更改”进行方便的导航。
• 选择一个更改的内容后，你还可以在最下面的编辑窗口中，进行最后的修改，然后点击确定即可，提示冲突已经解决，是否保存文件，点击是，当所有冲突都已经解决后，点击关闭，退出冲突处理，完成合并操作。
• 这个时候，我们打开合并的目标分支，因为修改的内容合并到了目标分支，目标分支的对应文件处于挂起的更改“合并，编辑”，需要对其进行签入操作，才能将最新的内容提交到TFS服务器上。

 

7. 一个源文件，如何知道它的 每一行都是什么时候签入的，为了什么目的签入的 （解决了哪个任务，或者哪个bug）？

   场景： 一个重要的软件忽然出现崩溃的情况，  程序员果冻经过各种debug手段，发现问题是在某一个文件中有一行代码似乎显然出了问题，但是这个模块被很多其他模块调用，这行代码是什么时候，为了什么目的，经过谁签入的呢？如果贸然修改，会不会导致其他问题呢？ 怎么办？

 

 

8. 如何给一个系统的所有源文件都打上 标签，这样别人可以同步所有有这个标签的文件版本？

   代码每天都在变， 有时质量变好，有时变差，我们需要一个 Last Known Good （最后稳定的好版本） 版本， 这样新员工就可以同步这个版本， 我们如果需要发布，也是从这个版本开始。那么如何标记这个 Last Known Good 版本呢？ 

 

9. 你的项目的 源代码和测试这些代码的单元测试，以及其他测试脚本都是放在一起的么？ 修改源代码会确保相应的测试也更新么？你的团队是否能部署自动构建的任务？

    在签入之前，程序员能否自动在自己的机器上运行自动测试，以保证本地修改不会影响整个软件的质量？

    在程序员提交签入之后，服务器上是否有自动测试程序， 完成编译，测试，如果成功，就签入，否则，就取消签入？

    团队是否配置了服务器，它自动同步所有文件，自动构建，自动运行相关的单元测试，碰到错误能自动发邮件给团队