SYsU-lang 实验一、二总结+常见问题指导（不定期更新）

<p><strong>SYsU-lang 实验一、二总结+常见问题指导（不定期更新）</strong></p>

<ul>
  <li>教师：张献伟</li>
  <li>助教：吴坎</li>
  <li><a href="mailto:wukan3@mail2.sysu.edu.cn">wukan3[at]mail2.sysu.edu.cn</a></li>
</ul>

<ul>
  <li>实验一：<a href="https://github.com/arcsysu/SYsU-lang/tree/latest/lexer">词法分析器实验</a>
    <ul>
      <li>预期耗时 2 小时 ～ 6 小时，代码 300 行</li>
      <li>共收到 62 份提交</li>
      <li>53 位同学得分为 100 分</li>
      <li>58 位同学得分为 95 分以上</li>
      <li>所有学号 <code class="language-plaintext highlighter-rouge">19</code> 开头的同学得分都在 90 分以上</li>
    </ul>
  </li>
</ul>

<ul>
  <li>实验二：<a href="https://github.com/arcsysu/SYsU-lang/tree/latest/parser">语法分析器实验</a>
    <ul>
      <li>预期耗时 24 小时 ～ 72 小时，代码 1000 行
        <ul>
          <li>难度阶梯上升、代码量线性增加，导致需要的时长平方增加？</li>
        </ul>
      </li>
      <li>目前为止共收到 48 份提交</li>
      <li>未提交的同学中有 6 位学号 <code class="language-plaintext highlighter-rouge">19</code> 开头
        <ul>
          <li>是否在实验上分配了足够的时间？</li>
          <li>可以寻求助教帮助！</li>
        </ul>
      </li>
      <li>预期 40 位以上的同学可以拿到满分</li>
    </ul>
  </li>
</ul>

<ul>
  <li>关于给分原则
    <ul>
      <li>助教给分原则是「通过式」，不强行符合正态分布</li>
      <li>主要扣分原因：迟交；提交格式</li>
      <li>实验报告不计入得分
        <ul>
          <li>约三分之一的同学仍然写了详细的实验心得与反馈</li>
          <li>非常鼓励，每一份报告都被认真看过</li>
          <li>不计入得分的感想与反馈更有参考价值！</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

<ul>
  <li>关于程序报错
    <ul>
      <li>不存在万能解决方案</li>
      <li>但是一定存在找到解决方案的方法</li>
      <li>也是助教面对同学提问的「通用回答」</li>
    </ul>
  </li>
</ul>

<ul>
  <li>找不到可执行文件/头文件/库文件
    <ul>
      <li><code class="language-plaintext highlighter-rouge">PATH</code>、<code class="language-plaintext highlighter-rouge">CPATH</code>、<code class="language-plaintext highlighter-rouge">LIBRARY_PATH</code>、<code class="language-plaintext highlighter-rouge">LD_LIBRARY_PATH</code></li>
      <li>这四个环境变量是在做什么？</li>
      <li>对应的环境变量正确吗？</li>
      <li>对应的环境变量中可以找到对应的文件吗？</li>
      <li>是否按 <code class="language-plaintext highlighter-rouge">README.md</code> 中的指令执行？</li>
      <li>是否改了测试脚本/测试数据？</li>
    </ul>
  </li>
</ul>

<ul>
  <li>段错误/执行结果错误
    <ul>
      <li>代码写的有问题
        <ul>
          <li>废话，但不完全是废话</li>
        </ul>
      </li>
      <li>「我肉眼看我的输出和参考输出差不多，为什么过不了测试？」
        <ul>
          <li>机器错了，你没有错？</li>
        </ul>
      </li>
      <li>助教在对同学代码了解更少的情况下解决了大部分提问
        <ul>
          <li>「噢，原来是这里看错了/写错了」</li>
          <li>大概是经验问题
            <ul>
              <li>也是这个实验希望带给大家的收获</li>
            </ul>
          </li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

<ul>
  <li>关于实验难度（总要写一个编译器吧?<del>虽然隔壁两个班确实不写</del>）
    <ul>
      <li>横向对比 <a href="https://decaf-lang.github.io/minidecaf-tutorial/">THU</a>、<a href="https://pku-minic.github.io/online-doc/#/">PKU</a> 实验
        <ul>
          <li>生成 RISC-V 汇编，需要学习 RISC-V 后端知识并掌握寄存器分配算法</li>
        </ul>
      </li>
      <li>横向对比 <a href="https://github.com/Komorebi660/SysYF-Compiler">USTC</a>、<a href="https://buaa-se-compiling.github.io/miniSysY-tutorial/">BUAA</a>、<a href="https://github.com/tinsir888/Compiler-SysY">NKU</a>
        <ul>
          <li>生成 LLVM IR，但不使用 LLVM 库开发</li>
        </ul>
      </li>
      <li>总代码量已经小了很多，如果有代码更少的方案欢迎 <a href="https://github.com/arcsysu/SYsU-lang/issues"><img src="https://img.shields.io/github/issues/arcsysu/SYsU-lang" alt="Issues" /></a>、<a href="https://github.com/arcsysu/SYsU-lang/pulls"><img src="https://img.shields.io/github/issues-pr/arcsysu/SYsU-lang" alt="Issues-pr" /></a>
        <ul>
          <li>实验设计与难度不是证明助教能力的舞台</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

<ul>
  <li>最难的地方：没有往届作业参考，没有博客抄
    <ul>
      <li>解决「卡脖子」问题，需要什么样的人才？</li>
      <li>不会 -> 多提问
        <ul>
          <li>不然助教也没有办法帮到你</li>
        </ul>
      </li>
      <li>目前关于实验三的提问仍然偏少
        <ul>
          <li>少数提问的同学中有进度靠前的</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

<ul>
  <li>关于提问
    <ul>
      <li>帮助同学是助教的职责</li>
      <li>会平等对待任何同学提出的任何问题</li>
      <li>不会「傲慢」，并接受任何关于态度的批评</li>
      <li><a href="https://github.com/arcsysu/SYsU-lang/discussions"><img src="https://img.shields.io/github/discussions/arcsysu/SYsU-lang" alt="Discussions" /></a>/私戳皆可
        <ul>
          <li>助教更希望前者，有解决过类似问题的同学也可以回答，同时也能帮助以后的同学</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

<ul>
  <li><a href="https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md">提问的智慧</a>
    <ul>
      <li>助教不会像上文一样「傲慢」</li>
      <li>但学会提问仍然对日后工作、科研、人际交往很有帮助</li>
      <li>RTFM（读文档）、STFW（善用搜索引擎）可以解决大部分问题</li>
      <li>希望大家的提问慢慢变多…然后慢慢变少！</li>
    </ul>
  </li>
</ul>

<ul>
  <li>仍然担心不会提问，此处提供一个模板
    <ul>
      <li>我的编译器在输入为 XXX 的时候出现了 YYY 问题 (附完整的报错信息或截图).</li>
      <li>我尝试 AAA, 发现 BBB, 我认为这代表 CCC.</li>
      <li>标准输出是 DDD, 和我的相比 EEE, 我认为这代表 FFF.</li>
      <li>综上所述, 我觉得问题可能出在 GGG, 但之后我就没思路了, 请问我的分析是否正确?</li>
      <li>导致问题的具体原因是什么呢?</li>
    </ul>
  </li>
</ul>

<h2 id="万丈高楼平地起">万丈高楼平地起</h2>