A class method is a method defined in Python through the @classmethod decorator. Its first parameter is the class itself (cls), which is used to access or modify the class state. It can be called through a class or instance, which affects the entire class rather than a specific instance; for example, in the Person class, the show_count() method counts the number of objects created; when defining a class method, you need to use the @classmethod decorator and name the first parameter cls, such as the change_var(new_value) method to modify class variables; the class method is different from the instance method (self parameter) and static method (no automatic parameters), and is suitable for factory methods, alternative constructors, and management of class variables. Common uses include creating objects from different initialization methods, unified management of subclass configurations, etc.
@classmethod
is a very practical decorator in Python that defines class methods. Unlike ordinary instance methods, the first parameter of a class method is the class itself (usually written as cls
), not the instance ( self
). This means you can call it through a class or instance and you can operate on the class without creating an object.

What is a class method?
A class method is a method associated with a class, not a specific instance of a class. @classmethod
is suitable when you want this method to access or modify the state of a class instead of a specific instance.

Let's give a simple example:
class Person: count = 0 def __init__(self): Person.count = 1 @classmethod def show_count(cls): print(f"Total people: {cls.count}")
In this example, show_count
is a class method. Whether you call it through the class name Person.show_count()
or through an instance, it outputs how many Person
objects are currently created.

How to define and use class methods?
Defining a class method is very simple. You just need to add an @classmethod
decorator before the method and name the first parameter cls
(this is a conventional way of writing).
class MyClass: class_var = "Hello" @classmethod def change_var(cls, new_value): cls.class_var = new_value
It is also very flexible to use:
-
MyClass.change_var("World")
- The instance can also call:
my_instance = MyClass(); my_instance.change_var("Hi")
Note: Although class methods can be called through an instance, it affects the state of the entire class, not the state unique to the instance.
Class method vs Static method vs Instance method
These three are easy to confuse. Let’s briefly distinguish their uses:
- Example method : The most common method, the first parameter is
self
, used to process data at the object level. - Class method (
@classmethod
) : The first parameter iscls
, suitable for scenarios where class-level attributes need to be accessed or modified. - Static method (
@staticmethod
) : There are noself
orcls
parameters passed in automatically, but it is more like "normal functions belonging to the class".
Give an example to illustrate the difference:
class User: role = "member" def instance_method(self): print("This is an instance method") @classmethod def class_method(cls): print(f"This is a class method from {cls.role}") @staticmethod def static_method(): print("This is a static method")
-
instance_method()
can only be called by instance. - Both
class_method()
andstatic_method()
can be called through classes or instances. -
static_method()
does not depend on the state of a class or instance at all.
What are the common usage scenarios?
Factory Method
Class methods are very suitable for "factory methods", that is, to return different instances of the class.class Point: def __init__(self, x, y): self.x = x self.y = y @classmethod def from_polar(cls, r, theta): # Convert polar coordinates to Cartesian coordinates import math return cls(r * math.cos(theta), r * math.sin(theta))
Modify class variables
If you have a set of subclasses inherited from the same parent class, and each subclass has its own configuration items, you can use class methods to manage these configurations uniformly.Alternative constructor
For example, you have multiple ways to initialize an object, and you can use multiple class methods to represent different construction logic.
Basically that's it. The key to understanding @classmethod
is to figure out that it acts on classes rather than instances and can be inherited and overridden. If you use it more, you will find that it is more useful than it looks.
The above is the detailed content of Python `@classmethod` decorator explained. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics

Polymorphism is a core concept in Python object-oriented programming, referring to "one interface, multiple implementations", allowing for unified processing of different types of objects. 1. Polymorphism is implemented through method rewriting. Subclasses can redefine parent class methods. For example, the spoke() method of Animal class has different implementations in Dog and Cat subclasses. 2. The practical uses of polymorphism include simplifying the code structure and enhancing scalability, such as calling the draw() method uniformly in the graphical drawing program, or handling the common behavior of different characters in game development. 3. Python implementation polymorphism needs to satisfy: the parent class defines a method, and the child class overrides the method, but does not require inheritance of the same parent class. As long as the object implements the same method, this is called the "duck type". 4. Things to note include the maintenance

The digital asset market attracts global attention with its high volatility. In this environment, how to steadily capture returns has become the goal pursued by countless participants. Quantitative trading, with its dependence on data and algorithm-driven characteristics, is becoming a powerful tool to deal with market challenges. Especially in 2025, this time node full of infinite possibilities is combined with the powerful programming language Python to build an automated "brick-moving" strategy, that is, to use the tiny price spreads between different trading platforms for arbitrage, which is considered a potential way to achieve efficient and stable profits.

A class method is a method defined in Python through the @classmethod decorator. Its first parameter is the class itself (cls), which is used to access or modify the class state. It can be called through a class or instance, which affects the entire class rather than a specific instance; for example, in the Person class, the show_count() method counts the number of objects created; when defining a class method, you need to use the @classmethod decorator and name the first parameter cls, such as the change_var(new_value) method to modify class variables; the class method is different from the instance method (self parameter) and static method (no automatic parameters), and is suitable for factory methods, alternative constructors, and management of class variables. Common uses include:

Golangofferssuperiorperformance,nativeconcurrencyviagoroutines,andefficientresourceusage,makingitidealforhigh-traffic,low-latencyAPIs;2.Python,whileslowerduetointerpretationandtheGIL,provideseasierdevelopment,arichecosystem,andisbettersuitedforI/O-bo

Parameters are placeholders when defining a function, while arguments are specific values ??passed in when calling. 1. Position parameters need to be passed in order, and incorrect order will lead to errors in the result; 2. Keyword parameters are specified by parameter names, which can change the order and improve readability; 3. Default parameter values ??are assigned when defined to avoid duplicate code, but variable objects should be avoided as default values; 4. args and *kwargs can handle uncertain number of parameters and are suitable for general interfaces or decorators, but should be used with caution to maintain readability.

TointegrateGolangserviceswithexistingPythoninfrastructure,useRESTAPIsorgRPCforinter-servicecommunication,allowingGoandPythonappstointeractseamlesslythroughstandardizedprotocols.1.UseRESTAPIs(viaframeworkslikeGininGoandFlaskinPython)orgRPC(withProtoco

Python's garbage collection mechanism automatically manages memory through reference counting and periodic garbage collection. Its core method is reference counting, which immediately releases memory when the number of references of an object is zero; but it cannot handle circular references, so a garbage collection module (gc) is introduced to detect and clean the loop. Garbage collection is usually triggered when the reference count decreases during program operation, the allocation and release difference exceeds the threshold, or when gc.collect() is called manually. Users can turn off automatic recycling through gc.disable(), manually execute gc.collect(), and adjust thresholds to achieve control through gc.set_threshold(). Not all objects participate in loop recycling. If objects that do not contain references are processed by reference counting, it is built-in

Iterators are objects that implement __iter__() and __next__() methods. The generator is a simplified version of iterators, which automatically implement these methods through the yield keyword. 1. The iterator returns an element every time he calls next() and throws a StopIteration exception when there are no more elements. 2. The generator uses function definition to generate data on demand, saving memory and supporting infinite sequences. 3. Use iterators when processing existing sets, use a generator when dynamically generating big data or lazy evaluation, such as loading line by line when reading large files. Note: Iterable objects such as lists are not iterators. They need to be recreated after the iterator reaches its end, and the generator can only traverse it once.
