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

一、一般规定

1. 诉讼时效期间：

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

2. 最长保护期限：

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

二、诉讼时效的中断

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

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

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

三、诉讼时效的中止

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

• 不可抗力事件导致无法行使权利，如自然灾害、战争等；
• 无民事行为能力人或限制民事行为能力人因没有法定代理人而无法行使权利。

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

举例说明：若在上述案例中，甲在诉讼时效期间的最后六个月内因遭遇不可抗力事件（如地震）而无法行使请求权，此时诉讼时效中止。待不可抗力事件消除后，诉讼时效期间将从消除之日起满六个月后届满。

四、特殊合同的诉讼时效

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

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

五、实际应用中的建议

1. 及时行使权利：在知道或应当知道权利受到损害后，应及时向义务人提出履行请求或采取其他法律措施，以避免诉讼时效过期。
2. 保留证据：妥善保管与合同纠纷相关的证据材料，如合同、交易记录、通信记录等，以便在诉讼或仲裁中证明自己的权利。
3. 关注特殊情形：对于可能涉及诉讼时效中断、中止或延长的情形，应密切关注并采取相应措施。

面对合同纠纷或其他法律问题，了解并合理运用诉讼时效的相关规定至关重要。如果你有任何具体的法律问题或需要进一步的法律帮助，请直接向我咨询。