合同纠纷的诉讼时效一般为三年，但需注意特殊情形下的中断、中止及延长规定。以下是对合同诉讼时效的详细解释：

一、一般规定

1. 诉讼时效期间：

   • 根据《中华人民共和国民法典》第一百八十八条的规定，向人民法院请求保护民事权利的诉讼时效期间通常为三年。这一时效期间自权利人知道或者应当知道权利受到损害以及义务人之日起计算。

2. 最长保护期限：

   • 自权利受到损害之日起超过二十年的，人民法院将不予保护。但在特殊情况下，如权利人能提供充分理由，人民法院可以根据其申请决定延长这一期限。

二、诉讼时效的中断

在诉讼时效期间内，若发生以下法定事由，将导致已过去的时效期间失效，诉讼时效将重新起算：

• 权利人向义务人明确提出履行请求；
• 义务人明确表示同意履行义务；
• 权利人提起诉讼或申请仲裁；
• 发生与提起诉讼或申请仲裁具有同等效力的其他情形。

举例说明：假设甲与乙签订了一份买卖合同，约定乙在收到货物后30天内支付货款。但乙在收到货物后一直未支付。甲在知道乙未支付货款后，于两年后向乙提出履行请求，此时诉讼时效中断，重新起算三年。

三、诉讼时效的中止

在诉讼时效期间的最后六个月内，若因以下原因权利人无法行使请求权，诉讼时效将中止：

• 不可抗力事件导致无法行使权利；
• 无民事行为能力人或限制民事行为能力人因没有法定代理人而无法行使权利。

当中止时效的原因消除后，诉讼时效期间将从消除之日起满六个月后届满。

举例说明：假设在上述买卖合同纠纷中，甲在诉讼时效期间的最后六个月内因突发疾病无法行使请求权，此时诉讼时效中止。待甲康复后，诉讼时效期间将从康复之日起满六个月后届满。

四、特殊规定

1. 特定合同的诉讼时效：

   • 对于国际货物买卖合同和技术进出口合同争议，提起诉讼或申请仲裁的时效期间为四年，这是基于法律的特殊规定。

2. 一年诉讼时效的特殊争议：

   • 对于租赁合同中延付或拒付租金的争议，以及保管合同中寄存物被丢失或损毁的争议，其诉讼时效为一年。

五、实际应用中的建议

1. 及时行使权利：

   • 权利人应在知道或应当知道权利受到损害后，及时行使请求权，避免超过诉讼时效期间。

2. 保留证据：

   • 权利人应保留好与义务人之间的沟通记录、合同文本等证据，以便在诉讼中证明自己的权利受到损害以及义务人的身份。

3. 关注特殊情形：

   • 权利人应关注诉讼时效的中断、中止及延长等特殊情形，以便在必要时采取相应措施保护自己的权益。

作为专业律师，我深知合同纠纷诉讼时效的复杂性和重要性。如果你在合同纠纷中遇到诉讼时效相关的问题，或者有任何其他法律疑问，都可以直接向我咨询。我会根据你的具体情况，为你提供全面、准确的法律建议。