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

一、一般规定

1. 诉讼时效期间：

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

2. 最长保护期限：

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

二、诉讼时效的中断

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

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

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

三、诉讼时效的中止

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

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

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

举例说明：假设甲与乙签订了一份租赁合同，约定乙在租赁期满后支付租金。然而，在租赁期满前，甲因遭遇不可抗力事件（如自然灾害）而无法行使请求权。此时，诉讼时效中止。待不可抗力事件消除后，诉讼时效期间将从消除之日起满六个月后届满。

四、特殊合同的诉讼时效

并非所有合同纠纷都适用三年的诉讼时效。例如：

• 国际货物买卖合同和技术进出口合同：根据相关法律规定，这类合同争议提起诉讼或者申请仲裁的时效期间为四年。
• 租赁合同中延付或拒付租金的争议：以及保管合同中寄存物被丢失或损毁的争议，其诉讼时效为一年（但需注意，这一规定在《民法典》实施后可能有所调整，具体应依据最新法律规定）。

五、实际应用中的建议

1. 及时行使权利：在合同纠纷中，权利人应及时行使自己的权利，避免超过诉讼时效期间而丧失胜诉权。
2. 保留证据：权利人应保留好与合同纠纷相关的证据，如合同文本、交易记录、沟通记录等，以便在诉讼中证明自己的权利。
3. 关注特殊情形：权利人应关注诉讼时效的中断、中止及延长等特殊情形，以便在必要时采取相应措施保护自己的权益。

如有任何关于合同诉讼时效的疑问或需要进一步的法律帮助，请直接向我咨询。我将根据你的具体情况，为你提供详细的法律建议和帮助。