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

一、一般规定

1. 诉讼时效期间：

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

2. 最长保护期限：

   • 自权利受到损害之日起超过二十年的，人民法院将不予保护。但在特殊情况下，人民法院可根据权利人的申请决定适当延长。

二、诉讼时效的中断

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

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

举例说明：假设甲与乙签订了一份买卖合同，约定乙在收到货物后30天内支付货款。但乙在收到货物后一直未支付。若甲在知道乙未支付货款后的三年内，向乙提出了支付请求，或者向法院提起了诉讼，那么诉讼时效将从中断时起重新计算三年。

三、诉讼时效的中止

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

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

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

举例说明：假设在上述买卖合同纠纷中，甲在知道乙未支付货款后的两年半时，因突发疾病无法行使请求权，且该疾病持续了四个月。那么，在这四个月内，诉讼时效将中止。当中止原因消除后，诉讼时效期间将从消除之日起满六个月后届满。

四、特殊合同的诉讼时效

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

• 国际货物买卖合同和技术进出口合同争议提起诉讼或者申请仲裁的时效期间为四年。
• 对于租赁合同中延付或拒付租金的争议，以及保管合同中寄存物被丢失或损毁的争议，其诉讼时效可能为一年（但需注意，这一规定可能因具体法律法规的修订而有所变化，需以最新法律法规为准）。不过，在大多数常规合同纠纷中，仍适用三年的诉讼时效。

五、实际应用中的建议

1. 及时行使权利：在知道或应当知道权利受到损害后，应及时向义务人提出履行请求或向法院提起诉讼，以避免诉讼时效的过期。
2. 保留证据：在行使权利的过程中，应保留好相关证据，如书面请求、诉讼材料等，以证明自己在诉讼时效期间内已经采取了行动。
3. 关注特殊情形：对于可能涉及诉讼时效中断、中止或延长的情形，应密切关注并采取相应措施。

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